Comercios
Crear una transferencia cripto
Transfiere criptoactivos al instante entre dos billeteras en custodia de comercios de VelaFi como transferencia interna, sin pagar comisiones de gas on-chain.
POST
/
v2
/
assets
/
internalTransfer
Crear una transferencia cripto
curl --request POST \
--url https://api-test.velafi.com/v2/assets/internalTransfer \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"fromMerchantId": 123,
"toMerchantId": 123,
"tokenId": "<string>",
"amount": 123,
"clientId": "<string>"
}
'import requests
url = "https://api-test.velafi.com/v2/assets/internalTransfer"
payload = {
"fromMerchantId": 123,
"toMerchantId": 123,
"tokenId": "<string>",
"amount": 123,
"clientId": "<string>"
}
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({
fromMerchantId: 123,
toMerchantId: 123,
tokenId: '<string>',
amount: 123,
clientId: '<string>'
})
};
fetch('https://api-test.velafi.com/v2/assets/internalTransfer', 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/assets/internalTransfer")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"fromMerchantId\": 123,\n \"toMerchantId\": 123,\n \"tokenId\": \"<string>\",\n \"amount\": 123,\n \"clientId\": \"<string>\"\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"id": "<string>",
"tokenId": "<string>",
"amount": "<string>",
"clientId": "<string>",
"merchantId": "<string>",
"fromMerchantId": "<string>",
"toMerchantId": "<string>"
}
}Usa este endpoint para mover criptoactivos de forma interna desde la billetera en custodia de VelaFi de un comercio a la de otro. Las transferencias internas se liquidan al instante sin pagar comisiones de gas de blockchain. El saldo del emisor muestra un
amount negativo (cargo) y el saldo del receptor muestra un amount positivo (abono). Envía un clientId para habilitar la idempotencia: las solicitudes duplicadas con el mismo clientId devuelven el resultado original en lugar de crear una segunda transferencia.
Todas las solicitudes deben incluir el header
X-BH-TOKEN y Content-Type: application/json.Endpoint
POST https://api.velafi.com/v2/assets/internalTransfer
Parámetros de la solicitud
number
requerido
ID del comercio que envía la cripto.
number
requerido
ID del comercio que recibe la cripto.
string
requerido
Símbolo del token que se va a transferir. Valores admitidos:
USDT, USDC, BTC, MMXN.number
requerido
Monto del token que se va a transferir.
string
Tu identificador único para esta transferencia. Se usa para la idempotencia.
Campos de la respuesta
number
Código de respuesta de estilo HTTP.
200 indica éxito.string
Mensaje de estado legible, por ejemplo
SUCCESS.object
Mostrar campos de data
Mostrar campos de data
string
ID de registro único de esta transferencia.
string
Token que se transfirió.
string
Monto transferido. Negativo en el registro del emisor (cargo), positivo en el del receptor (abono).
string
El identificador que proporcionaste para esta transferencia.
string
ID del comercio al que pertenece este registro (igual que
fromMerchantId).string
ID del comercio emisor.
string
ID del comercio receptor.
Ejemplo
cURL
curl -X POST https://api.velafi.com/v2/assets/internalTransfer \
-H "X-BH-TOKEN: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"fromMerchantId": 246,
"toMerchantId": 61,
"tokenId": "USDT",
"amount": 10,
"clientId": "crypto-transfer-001"
}'
Response
{
"code": 200,
"msg": "SUCCESS",
"data": {
"id": "4352",
"tokenId": "USDT",
"amount": "-10",
"clientId": "crypto-transfer-001",
"merchantId": "246",
"fromMerchantId": "246",
"toMerchantId": "61"
}
}
El
amount de la respuesta es negativo porque representa el cargo en la cuenta del emisor. Usa el endpoint Consultar transferencias de cripto para ver ambos lados de la transferencia.⌘I
Crear una transferencia cripto
curl --request POST \
--url https://api-test.velafi.com/v2/assets/internalTransfer \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"fromMerchantId": 123,
"toMerchantId": 123,
"tokenId": "<string>",
"amount": 123,
"clientId": "<string>"
}
'import requests
url = "https://api-test.velafi.com/v2/assets/internalTransfer"
payload = {
"fromMerchantId": 123,
"toMerchantId": 123,
"tokenId": "<string>",
"amount": 123,
"clientId": "<string>"
}
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({
fromMerchantId: 123,
toMerchantId: 123,
tokenId: '<string>',
amount: 123,
clientId: '<string>'
})
};
fetch('https://api-test.velafi.com/v2/assets/internalTransfer', 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/assets/internalTransfer")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"fromMerchantId\": 123,\n \"toMerchantId\": 123,\n \"tokenId\": \"<string>\",\n \"amount\": 123,\n \"clientId\": \"<string>\"\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"id": "<string>",
"tokenId": "<string>",
"amount": "<string>",
"clientId": "<string>",
"merchantId": "<string>",
"fromMerchantId": "<string>",
"toMerchantId": "<string>"
}
}