Comercios
Obtener la dirección de depósito cripto
Obtén la dirección de depósito on-chain de un token y una red blockchain específicos para la billetera de un comercio, incluidos los requisitos de confirmación.
GET
/
v2
/
assets
/
depositAddress
Obtener la dirección de depósito cripto
curl --request GET \
--url https://api-test.velafi.com/v2/assets/depositAddress \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/depositAddress"
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/depositAddress', 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/depositAddress")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"allowDeposit": true,
"address": "<string>",
"addressExt": "<string>",
"minQuantity": "<string>",
"needAddressTag": true,
"requiredConfirmNum": 123,
"canWithdrawConfirmNum": 123,
"tokenType": "<string>"
}
}Usa este endpoint para obtener la dirección de depósito on-chain de una criptomoneda y una red específicas. Debes proporcionar tanto un
tokenId como un chainType de las combinaciones admitidas que se indican abajo. La respuesta incluye la dirección de depósito, el tag de dirección requerido si aplica (por ejemplo, para XRP o EOS), el monto mínimo de depósito y los requisitos de confirmación.
Todas las solicitudes deben incluir el header
X-BH-TOKEN con un token de negocio obtenido de GET /v2/token/generate.Endpoint
GET https://api.velafi.com/v2/assets/depositAddress
Parámetros de consulta
string
requerido
Símbolo del token que se va a depositar. Valores admitidos:
USDT, USDC, BTC, COPM, BRL1, MXNB, MMXN.string
requerido
Identificador de la red blockchain. Debe ser una combinación válida para el
tokenId seleccionado. Consulta la tabla de combinaciones admitidas más abajo.integer
requerido
ID del comercio cuya dirección de depósito quieres obtener.
Combinaciones de token y red admitidas
| tokenId | chainType | Red |
|---|---|---|
USDT | TRC20 | Tron |
USDT | ERC20 | Ethereum |
USDT | BEP20 | BNB Smart Chain |
USDT | POL | Polygon |
USDT | SPL20 | Solana Mainnet |
USDC | ERC20 | Ethereum |
USDC | POL | Polygon |
USDC | SPL20 | Solana Mainnet |
BTC | BTC | Bitcoin |
COPM | POL | Polygon (POS) |
BRL1 | POL | Polygon (POS) |
MXNB | Arbitrum | Arbitrum Network |
MMXN | ERC20 | Ethereum (ERC20) |
MMXN | TRC20 | TRON (TRC20) |
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
boolean
Indica si los depósitos están habilitados actualmente para esta dirección.
string
La dirección de depósito on-chain.
string
Tag o memo de la dirección (obligatorio para algunos tokens). Cadena vacía si no se necesita.
string
Monto mínimo de depósito para este token.
boolean
Indica si se debe incluir un tag de dirección en la transacción de depósito.
number
Número de confirmaciones on-chain necesarias antes de que se acredite el depósito.
number
Número de confirmaciones on-chain necesarias antes de que los fondos depositados se puedan retirar.
string
Identificador interno del tipo de token.
Ejemplo
cURL
curl -G https://api.velafi.com/v2/assets/depositAddress \
-H "X-BH-TOKEN: YOUR_TOKEN" \
--data-urlencode "tokenId=USDT" \
--data-urlencode "chainType=TRC20" \
--data-urlencode "merchantId=12345"
Respuesta
{
"code": 200,
"msg": "SUCCESS",
"data": {
"allowDeposit": true,
"address": "YOUR_DEPOSIT_ADDRESS",
"addressExt": "",
"minQuantity": "5",
"needAddressTag": false,
"requiredConfirmNum": 12,
"canWithdrawConfirmNum": 20,
"tokenType": "TRX_TOKEN"
}
}
Revisa siempre
allowDeposit antes de mostrar la dirección a los usuarios. Si allowDeposit es false, es posible que los fondos enviados a esta dirección no se acrediten. Contacta al soporte de VelaFi si el indicador sigue en false de forma inesperada.⌘I
Obtener la dirección de depósito cripto
curl --request GET \
--url https://api-test.velafi.com/v2/assets/depositAddress \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/depositAddress"
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/depositAddress', 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/depositAddress")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"allowDeposit": true,
"address": "<string>",
"addressExt": "<string>",
"minQuantity": "<string>",
"needAddressTag": true,
"requiredConfirmNum": 123,
"canWithdrawConfirmNum": 123,
"tokenType": "<string>"
}
}