Comercios
Listar transferencias cripto
Consulta el historial completo de transferencias internas de cripto entre billeteras de comercios, con filtros por símbolo de token, rango de fechas e ID de cliente.
GET
/
v2
/
assets
/
internalTransferOrders
Listar transferencias cripto
curl --request GET \
--url https://api-test.velafi.com/v2/assets/internalTransferOrders \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/internalTransferOrders"
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/assets/internalTransferOrders', 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/assets/internalTransferOrders")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"id": "<string>",
"tokenId": "<string>",
"amount": "<string>",
"clientId": "<string>",
"merchantId": "<string>",
"fromMerchantId": "<string>",
"toMerchantId": "<string>"
}
]
}Usa este endpoint para obtener el historial de transferencias internas de cripto en las que participan una o más billeteras de comercios. Cada transferencia completada genera dos registros: un asiento negativo (cargo) del lado del remitente y un asiento positivo (abono) del lado del destinatario. Usa el filtro
merchantId para limitar los resultados a un solo comercio. Combínalo con el endpoint Transferencia de cripto para armar un rastro de auditoría completo.
Todas las solicitudes deben incluir el encabezado
X-BH-TOKEN con un token de negocio obtenido de GET /v2/token/generate.Endpoint
GET https://api.velafi.com/v2/assets/internalTransferOrders
Parámetros de consulta
number
Filtra los registros por ID de comercio.
string
Filtra por símbolo de token, por ejemplo
USDT, BTC.string
Filtra por el identificador de transferencia que proporcionaste.
number
Inicio del rango de fechas como marca de tiempo Unix en milisegundos.
number
Fin del rango de fechas como marca de tiempo Unix en milisegundos.
number
Número de registros que se devuelven por página.
Campos de la respuesta
number
Código de respuesta de tipo HTTP.
200 indica éxito.string
Mensaje de estado legible, por ejemplo
SUCCESS.array
Mostrar Campos de cada elemento de data
Mostrar Campos de cada elemento de data
string
ID único del registro para esta línea de transferencia.
string
Símbolo del token de este registro.
string
Monto transferido. Negativo = cargo (remitente), positivo = abono (destinatario).
string
El identificador de transferencia que proporcionaste.
string
ID del comercio al que pertenece este registro.
string
ID del comercio remitente.
string
ID del comercio destinatario.
Ejemplo
cURL
curl -G https://api.velafi.com/v2/assets/internalTransferOrders \
-H "X-BH-TOKEN: YOUR_TOKEN" \
--data-urlencode "merchantId=246" \
--data-urlencode "tokenId=USDT" \
--data-urlencode "pageSize=10"
Respuesta
{
"code": 200,
"msg": "SUCCESS",
"data": [
{
"id": "4355",
"tokenId": "USDT",
"amount": "10",
"clientId": "crypto-transfer-001",
"merchantId": "61",
"fromMerchantId": "246",
"toMerchantId": "61"
},
{
"id": "4354",
"tokenId": "USDT",
"amount": "-10",
"clientId": "crypto-transfer-001",
"merchantId": "246",
"fromMerchantId": "246",
"toMerchantId": "61"
}
]
}
Una sola transferencia crea dos registros: uno para el remitente (
amount negativo) y otro para el destinatario (amount positivo). El campo merchantId indica desde la perspectiva de qué comercio se presenta cada registro.⌘I
Listar transferencias cripto
curl --request GET \
--url https://api-test.velafi.com/v2/assets/internalTransferOrders \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/internalTransferOrders"
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/assets/internalTransferOrders', 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/assets/internalTransferOrders")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"id": "<string>",
"tokenId": "<string>",
"amount": "<string>",
"clientId": "<string>",
"merchantId": "<string>",
"fromMerchantId": "<string>",
"toMerchantId": "<string>"
}
]
}