API de utilidades
Endpoints de utilidad para consultar saldos, tipos de cambio y criptomonedas admitidas.
Puntos de conexión de utilidad para consultar saldos, tipos de cambio y criptomonedas admitidas.
get-credit-balance
Consulta tu saldo de créditos. Los créditos se utilizan para el sistema de deducción de comisiones de QuantaPay.
Solicitud
curl -X POST https://cloud.quantapay.app/api.php \
-d "function=get-credit-balance" \
-d "api-key=YOUR_API_KEY"
Respuesta
{
"success": true,
"response": {
"credit_balance": 150.00,
"credit_currency": "USD"
}
}
| Campo | Tipo | Descripción |
|---|---|---|
credit_balance | number | Tu saldo de créditos actual. |
credit_currency | string | La moneda de tu saldo de créditos (normalmenteUSD). |
get-balances
Consulta los saldos de criptomonedas de todas las direcciones de monedero que hayas configurado.
Solicitud
curl -X POST https://cloud.quantapay.app/api.php \
-d "function=get-balances" \
-d "api-key=YOUR_API_KEY"
Respuesta
Devuelve datos de saldo para todas las direcciones de criptomonedas configuradas.
{
"success": true,
"response": {
"btc": {
"amount": "0.5432",
"fiat": "35210.50"
},
"eth": {
"amount": "12.345",
"fiat": "45678.90"
}
}
}
get-exchange-rates
Obtén el tipo de cambio actual entre una moneda fiduciaria y una criptomoneda.
Solicitud
curl -X POST https://cloud.quantapay.app/api.php \
-d "function=get-exchange-rates" \
-d "api-key=YOUR_API_KEY" \
-d "currency_code=USD" \
-d "cryptocurrency_code=btc"
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
currency_code | string | Sí | Código de moneda fiduciaria (p. ej.,USD, EUR). |
cryptocurrency_code | string | Sí | Código de criptomoneda (p. ej.,btc, eth). |
Respuesta
{
"success": true,
"response": "64850.25"
}
La respuesta es el precio de 1 unidad de la criptomoneda en la moneda fiduciaria especificada.
get-fiat-value
Convierte una cantidad de criptomoneda a su equivalente fiduciario.
Solicitud
curl -X POST https://cloud.quantapay.app/api.php \
-d "function=get-fiat-value" \
-d "api-key=YOUR_API_KEY" \
-d "amount=0.5" \
-d "cryptocurrency_code=btc" \
-d "currency_code=USD"
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
amount | number | Sí | Cantidad de criptomoneda a convertir. |
cryptocurrency_code | string | Sí | Código de criptomoneda (p. ej.,btc, eth). |
currency_code | string | Sí | Código de moneda fiduciaria de destino (p. ej.,USD). |
Respuesta
{
"success": true,
"response": "32425.13"
}
get-cryptocurrency-codes
Obtén la lista de todos los códigos de criptomonedas admitidos y sus agrupaciones de red.
⚠️ Nota: Esta función está registrada en el enrutador de la API (
api.php) pero no tiene un controlador en el backend (ajax.php). Al llamarla, se superará la validación de parámetros, pero se devolverá una respuesta vacía. Se debe implementar un controlador para que este endpoint funcione.
Solicitud
curl -X POST https://cloud.quantapay.app/api.php \
-d "function=get-cryptocurrency-codes" \
-d "api-key=YOUR_API_KEY" \
-d "cryptocurrency_code="
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
cryptocurrency_code | string | Sí | Pasa una cadena vacía para obtener todos los códigos, o un nombre de blockchain (p. ej.,eth) para obtener los códigos solo para esa red. |
Respuesta esperada
{
"success": true,
"response": {
"BTC": ["btc"],
"ETH": ["eth", "usdt", "usdc", "link", "shib", "bat"],
"SOL": ["sol"],
"TRX": ["usdt_tron"],
"BSC": ["bnb", "busd", "usdt_bsc"],
"XRP": ["xrp"],
"LTC": ["ltc"],
"DOGE": ["doge"],
"BCH": ["bch"],
"ALGO": ["algo"],
"XMR": ["xmr"]
}
}
La respuesta asigna redes blockchain a sus códigos de criptomonedas admitidos. También se incluyen los tokens personalizados (añadidos a través de Ajustes → Pagos → Token personalizado).