Comercios
Transferir fondos Pending Fund
Mueve saldo fiat de la cuenta Pending Fund de un comercio a otro comercio dentro de la plataforma de VelaFi, al instante y sin transferencia bancaria.
POST
/
v2
/
merchant
/
transfer
Transferir fondos Pending Fund
curl --request POST \
--url https://api-test.velafi.com/v2/merchant/transfer \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"clientId": "<string>",
"fromMerchantId": 123,
"toMerchantId": 123,
"fiat": "<string>",
"paymentId": 123,
"fiatAmount": 123
}
'import requests
url = "https://api-test.velafi.com/v2/merchant/transfer"
payload = {
"clientId": "<string>",
"fromMerchantId": 123,
"toMerchantId": 123,
"fiat": "<string>",
"paymentId": 123,
"fiatAmount": 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({
clientId: '<string>',
fromMerchantId: 123,
toMerchantId: 123,
fiat: '<string>',
paymentId: 123,
fiatAmount: 123
})
};
fetch('https://api-test.velafi.com/v2/merchant/transfer', 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/merchant/transfer")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"clientId\": \"<string>\",\n \"fromMerchantId\": 123,\n \"toMerchantId\": 123,\n \"fiat\": \"<string>\",\n \"paymentId\": 123,\n \"fiatAmount\": 123\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"clientId": "<string>",
"fromId": 123,
"toId": 123,
"fiat": "<string>",
"fiatAmount": "<string>",
"totalFiatAmount": "<string>",
"fee": "<string>",
"createTime": 123
}
}Usa este endpoint para transferir fondos en fiat entre dos cuentas de comercio dentro del sistema de VelaFi. La transferencia es interna y no requiere una transacción bancaria. Tanto el comercio que envía como el que recibe deben tener cuentas activas para la combinación de
fiat y paymentId especificada. Usa primero el endpoint Comisión de transferencia para revisar los costos aplicables antes de iniciar la transferencia.
Todas las solicitudes deben incluir el encabezado
X-BH-TOKEN y Content-Type: application/json. El clientId se usa para la idempotencia: los valores de clientId duplicados devuelven el resultado original.Endpoint
POST https://api.velafi.com/v2/merchant/transfer
Parámetros de la solicitud
string
requerido
Tu identificador único para esta transferencia. Se usa para eliminar duplicados y para el rastreo.
number
requerido
ID del comercio que envía los fondos.
number
requerido
ID del comercio que recibe los fondos.
string
requerido
Moneda fiat que se transferirá. Valores admitidos:
MXN, ARS, COP, BRL, PEN.number
requerido
ID del canal de pago correspondiente a la moneda fiat:
105o72— MXN63— ARS68— COP90— BRL95— PEN
number
requerido
Monto que se transferirá en la moneda fiat especificada.
Campos de la respuesta
number
Código de respuesta de tipo HTTP.
200 indica éxito.string
Mensaje de estado legible, por ejemplo
SUCCESS.object
Mostrar Campos de data
Mostrar Campos de data
string
El identificador que proporcionaste, devuelto tal cual.
number
ID del registro de fondeo en la cuenta del remitente (asiento de cargo).
number
ID del registro de fondeo en la cuenta del destinatario (asiento de abono).
string
Moneda fiat de la transferencia.
string
Monto neto transferido.
string
Monto total descontado al remitente (fiatAmount + comisión).
string
Comisión cobrada por esta transferencia.
number
Marca de tiempo Unix (milisegundos) en la que se creó la transferencia.
Ejemplos
- MXN
- ARS
- COP / BRL / PEN
cURL
curl -X POST https://api.velafi.com/v2/merchant/transfer \
-H "X-BH-TOKEN: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"clientId": "transfer-mxn-001",
"fromMerchantId": 434,
"toMerchantId": 5,
"fiat": "MXN",
"paymentId": 105,
"fiatAmount": 10
}'
Respuesta
{
"code": 200,
"msg": "SUCCESS",
"data": {
"clientId": "transfer-mxn-001",
"fromId": 521006138624569344,
"toId": 521006138641346560,
"fiat": "MXN",
"fiatAmount": "10",
"totalFiatAmount": "10",
"fee": "0",
"createTime": 1746694343261
}
}
Cuerpo de la solicitud
{
"clientId": "transfer-ars-001",
"fromMerchantId": 434,
"toMerchantId": 5,
"fiat": "ARS",
"paymentId": 63,
"fiatAmount": 10
}
Respuesta
{
"code": 200,
"msg": "SUCCESS",
"data": {
"clientId": "transfer-ars-001",
"fromId": 521006138624569345,
"toId": 521006138641346561,
"fiat": "ARS",
"fiatAmount": "10",
"totalFiatAmount": "10",
"fee": "0",
"createTime": 1746694343261
}
}
Cuerpo de la solicitud COP
{
"clientId": "transfer-cop-001",
"fromMerchantId": 15127301,
"toMerchantId": 15127302,
"fiat": "COP",
"paymentId": 68,
"fiatAmount": 10
}
Cuerpo de la solicitud BRL
{
"clientId": "transfer-brl-001",
"fromMerchantId": 15127301,
"toMerchantId": 15127302,
"fiat": "BRL",
"paymentId": 90,
"fiatAmount": 10
}
Cuerpo de la solicitud PEN
{
"clientId": "transfer-pen-001",
"fromMerchantId": 15127301,
"toMerchantId": 15127302,
"fiat": "PEN",
"paymentId": 95,
"fiatAmount": 10
}
Usa los valores
fromId y toId para buscar los asientos correspondientes en el endpoint de registros de fondeo y obtener el rastro de auditoría completo.⌘I
Transferir fondos Pending Fund
curl --request POST \
--url https://api-test.velafi.com/v2/merchant/transfer \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"clientId": "<string>",
"fromMerchantId": 123,
"toMerchantId": 123,
"fiat": "<string>",
"paymentId": 123,
"fiatAmount": 123
}
'import requests
url = "https://api-test.velafi.com/v2/merchant/transfer"
payload = {
"clientId": "<string>",
"fromMerchantId": 123,
"toMerchantId": 123,
"fiat": "<string>",
"paymentId": 123,
"fiatAmount": 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({
clientId: '<string>',
fromMerchantId: 123,
toMerchantId: 123,
fiat: '<string>',
paymentId: 123,
fiatAmount: 123
})
};
fetch('https://api-test.velafi.com/v2/merchant/transfer', 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/merchant/transfer")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"clientId\": \"<string>\",\n \"fromMerchantId\": 123,\n \"toMerchantId\": 123,\n \"fiat\": \"<string>\",\n \"paymentId\": 123,\n \"fiatAmount\": 123\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"clientId": "<string>",
"fromId": 123,
"toId": 123,
"fiat": "<string>",
"fiatAmount": "<string>",
"totalFiatAmount": "<string>",
"fee": "<string>",
"createTime": 123
}
}