Beneficiarios
Configurar la cuenta de reembolso
Designa un beneficiario validado como cuenta de reembolso de un comercio. Cuando una orden se revierte, VelaFi envía los fondos a esta cuenta automáticamente.
POST
/
v2
/
payments
/
refund_account
Configurar la cuenta de reembolso
curl --request POST \
--url https://api-test.velafi.com/v2/payments/refund_account \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"userPaymentId": 123,
"merchantId": 123
}
'import requests
url = "https://api-test.velafi.com/v2/payments/refund_account"
payload = {
"userPaymentId": 123,
"merchantId": 123
}
headers = {
"X-BH-TOKEN": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-BH-TOKEN': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({userPaymentId: 123, merchantId: 123})
};
fetch('https://api-test.velafi.com/v2/payments/refund_account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api-test.velafi.com/v2/payments/refund_account")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"userPaymentId\": 123,\n \"merchantId\": 123\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": true
}Cuando una orden de fiat a cripto o de pagos globales se revierte o se reembolsa, VelaFi necesita saber a dónde enviar los fondos. Usa este endpoint para designar cualquier beneficiario validado previamente como la cuenta de reembolso de un comercio determinado. Cada comercio puede tener una sola cuenta de reembolso activa a la vez: si vuelves a llamar a este endpoint con un
userPaymentId distinto, se reemplaza la designación anterior.
Endpoint
POST https://api.velafi.com/v2/payments/refund_account
Usa
https://api-test.velafi.com/v2/payments/refund_account para pruebas en sandbox.Encabezados de la solicitud
| Encabezado | Valor |
|---|---|
X-BH-TOKEN | Tu token de GET /v2/token/generate |
Content-Type | application/json |
Parámetros del cuerpo de la solicitud
integer
requerido
El ID numérico único del beneficiario que quieres designar como cuenta de reembolso. El beneficiario debe tener
status: 1 (válido).integer
requerido
El ID numérico del comercio para el que se configura la cuenta de reembolso.
Campos de la respuesta
integer
Código de estado de la respuesta.
200 indica éxito.string
Mensaje de respuesta legible.
boolean
true si la cuenta de reembolso se designó correctamente.Ejemplo
curl -X POST "https://api.velafi.com/v2/payments/refund_account" \
-H "X-BH-TOKEN: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"merchantId": 456,
"userPaymentId": 123
}'
{
"code": 200,
"msg": "SUCCESS",
"data": true
}
Después de configurar una cuenta de reembolso, el campo
hasRefundAccount del beneficiario correspondiente devolverá 1 en las respuestas de GET /v2/payments.⌘I
Configurar la cuenta de reembolso
curl --request POST \
--url https://api-test.velafi.com/v2/payments/refund_account \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"userPaymentId": 123,
"merchantId": 123
}
'import requests
url = "https://api-test.velafi.com/v2/payments/refund_account"
payload = {
"userPaymentId": 123,
"merchantId": 123
}
headers = {
"X-BH-TOKEN": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-BH-TOKEN': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({userPaymentId: 123, merchantId: 123})
};
fetch('https://api-test.velafi.com/v2/payments/refund_account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api-test.velafi.com/v2/payments/refund_account")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"userPaymentId\": 123,\n \"merchantId\": 123\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": true
}