Configuración
Listar métodos de pago fiat→cripto
Obtén los métodos de pago disponibles para un par de on-ramp fiat a cripto, incluidas las comisiones y si cada método es automático o manual.
GET
/
v2
/
base
/
buy
/
payments
Listar métodos de pago fiat→cripto
curl --request GET \
--url https://api-test.velafi.com/v2/base/buy/payments \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/buy/payments"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/base/buy/payments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/base/buy/payments")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"country": "<string>",
"fiat": "<string>",
"crypto": "<string>",
"paymentList": [
{
"paymentId": 123,
"fiatFee": "<string>",
"paymentType": 123,
"trench": "<string>"
}
]
}
}Usa el endpoint GET
/v2/base/buy/payments para obtener los métodos de pago disponibles para un par de on-ramp fiat a cripto específico. Envía como parámetros de consulta el país, la moneda fiat y la criptomoneda de destino. La respuesta lista cada método de pago elegible junto con su comisión y su tipo de procesamiento (automático o manual), para que puedas mostrar a tus usuarios las opciones correctas antes de que inicien una compra.
Solicitud
GET /v2/base/buy/payments
Headers
| Header | Valor | Obligatorio |
|---|---|---|
X-BH-TOKEN | Tu token obtenido de GET /v2/token/generate | ✓ |
Parámetros de consulta
string
requerido
Nombre del país asociado a la moneda fiat (p. ej.,
"Mexico").string
requerido
Código ISO 4217 de la moneda fiat (p. ej.,
"MXN").string
requerido
Símbolo (ticker) de la criptomoneda de destino (p. ej.,
"USDT").Campos de la respuesta
number
Código de estado tipo HTTP.
200 indica éxito.string
Mensaje de estado legible, p. ej.
"SUCCESS".object
Objeto que contiene el par devuelto y sus métodos de pago disponibles.
Mostrar data
Mostrar data
string
Nombre del país, devuelto tal como se envió en la solicitud.
string
Código de la moneda fiat, devuelto tal como se envió en la solicitud.
string
Símbolo de la criptomoneda, devuelto tal como se envió en la solicitud.
array
Lista de objetos de método de pago disponibles para este par.
Mostrar paymentList[]
Mostrar paymentList[]
Ejemplo
cURL
curl --request GET \
--url 'https://api.velafi.com/v2/base/buy/payments?country=Mexico&fiat=MXN&crypto=USDT' \
--header 'X-BH-TOKEN: YOUR_TOKEN'
Respuesta
{
"code": 200,
"msg": "SUCCESS",
"data": {
"country": "Mexico",
"fiat": "MXN",
"crypto": "USDT",
"paymentList": [
{
"paymentId": 72,
"fiatFee": "0",
"paymentType": 1,
"trench": "CLABE - TESORED"
},
{
"paymentId": 105,
"fiatFee": "0",
"paymentType": 1,
"trench": "CLABE - FINCO PAY"
}
]
}
}
Los métodos con
paymentType: 1 (automáticos) se completan sin intervención manual. Los métodos con paymentType: 0 (manuales) requieren revisión humana y pueden tardar más en procesarse.⌘I
Listar métodos de pago fiat→cripto
curl --request GET \
--url https://api-test.velafi.com/v2/base/buy/payments \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/buy/payments"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/base/buy/payments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/base/buy/payments")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"country": "<string>",
"fiat": "<string>",
"crypto": "<string>",
"paymentList": [
{
"paymentId": 123,
"fiatFee": "<string>",
"paymentType": 123,
"trench": "<string>"
}
]
}
}