Configuración
Listar métodos de pago fiat→fiat
Obtén los métodos de pago de un corredor de pagos globales de fiat a fiat, con listas separadas para la moneda de envío y la de recepción.
GET
/
v2
/
base
/
fiat
/
payments
Listar métodos de pago fiat→fiat
curl --request GET \
--url https://api-test.velafi.com/v2/base/fiat/payments \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/fiat/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/fiat/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/fiat/payments")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"onRampCountry": "<string>",
"onRampFiat": "<string>",
"offRampCountry": "<string>",
"offRampFiat": "<string>",
"paymentListFrom": [
{
"paymentId": 123,
"fiatFee": "<string>",
"paymentType": 123
}
],
"paymentListTo": [
{
"paymentId": 123,
"fiatFee": "<string>",
"paymentType": 123
}
]
}
}Usa el endpoint GET
/v2/base/fiat/payments para obtener los métodos de pago disponibles para un corredor de pagos globales de fiat a fiat. Indica el país y la moneda de origen (on-ramp) y de destino (off-ramp) como parámetros de consulta. La respuesta devuelve dos listas separadas de métodos de pago, una para el lado que envía y otra para el lado que recibe, cada una con su comisión y su tipo de procesamiento. Usa estos datos para mostrar los canales de pago correctos en ambos extremos de un pago transfronterizo.
Solicitud
GET /v2/base/fiat/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 de origen (por ejemplo,
"Mexico").string
requerido
Código ISO 4217 de la moneda fiat de origen (por ejemplo,
"MXN").string
requerido
Nombre del país de destino (por ejemplo,
"Argentina").string
requerido
Código ISO 4217 de la moneda fiat de destino (por ejemplo,
"ARS").Campos de la respuesta
number
Código de estado de estilo HTTP.
200 indica éxito.string
Mensaje de estado legible, por ejemplo
"SUCCESS".object
Objeto que contiene el corredor devuelto tal como se envió y sus métodos de pago para ambos lados.
Mostrar data
Mostrar data
string
País de origen, devuelto tal como se envió en la solicitud.
string
Código de la moneda fiat de origen, devuelto tal como se envió en la solicitud.
string
País de destino, devuelto tal como se envió en la solicitud.
string
Código de la moneda fiat de destino, devuelto tal como se envió en la solicitud.
array
array
Ejemplo
cURL
curl --request GET \
--url 'https://api.velafi.com/v2/base/fiat/payments?onRampCountry=Mexico&onRampFiat=MXN&offRampCountry=Argentina&offRampFiat=ARS' \
--header 'X-BH-TOKEN: YOUR_TOKEN'
Respuesta
{
"code": 200,
"msg": "SUCCESS",
"data": {
"onRampCountry": "Mexico",
"onRampFiat": "MXN",
"offRampCountry": "Argentina",
"offRampFiat": "ARS",
"paymentListFrom": [
{
"paymentId": 1,
"fiatFee": "2",
"paymentType": 1
},
{
"paymentId": 2,
"fiatFee": "1.50",
"paymentType": 0
}
],
"paymentListTo": [
{
"paymentId": 1,
"fiatFee": "2",
"paymentType": 1
},
{
"paymentId": 3,
"fiatFee": "1.75",
"paymentType": 0
}
]
}
}
paymentListFrom y paymentListTo pueden contener métodos y comisiones diferentes porque los canales de envío y de recepción operan de forma independiente. Muestra ambas listas al usuario y obtén una selección de paymentId para cada lado antes de crear la orden de pago.⌘I
Listar métodos de pago fiat→fiat
curl --request GET \
--url https://api-test.velafi.com/v2/base/fiat/payments \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/fiat/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/fiat/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/fiat/payments")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"onRampCountry": "<string>",
"onRampFiat": "<string>",
"offRampCountry": "<string>",
"offRampFiat": "<string>",
"paymentListFrom": [
{
"paymentId": 123,
"fiatFee": "<string>",
"paymentType": 123
}
],
"paymentListTo": [
{
"paymentId": 123,
"fiatFee": "<string>",
"paymentType": 123
}
]
}
}