API de facturas cripto con checkout alojado
Crea facturas cripto de forma programática, obtén un enlace de checkout alojado para cada pago y recibe webhooks de estado final con tipo de cambio fijo por factura.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR"
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}API de facturas cripto
- Mapeo de externalId
- redirectUrl en la respuesta
- Webhook en el estado final
x-api-key: sk_live_…
{
"id": "order_1024",
"status": "paid"
}1 solicitud, 1 redirección, 1 webhook
Crea un pago, redirige al cliente y procesa el webhook final: toda la integración cabe en una página.
Crea el pago con externalId, importe, moneda y URLs.
Redirige al cliente a data.redirectUrl.
Recibe el webhook con estado final: wait, processing, completed o rejected.
Cobra en tu moneda, contabiliza en USD
Indica el importe en cualquier moneda ISO-4217 con el campo currency, por ejemplo INR, RUB o EUR. Sin él, el importe es en USD, como antes.
- El tipo de cambio de Qvard se fija una vez, al crear el pago. El pagador ve el importe en tu moneda y el importe en el token con el que paga; el pago se registra en USD.
- Los límites se comprueban en USD tras la conversión. Si el importe queda fuera del rango, el error muestra el límite en tu moneda.
- Los tipos actuales están en la página de tipos de cambio y en la API: GET /api/v1/rates, sin clave. En la configuración de tu tienda puedes fijar tu propio tipo para cada moneda.
- Errores: 422 unsupported_currency — moneda no admitida; 422 rate_unavailable — no hay tipo de cambio; 422 invalid_amount_precision — más decimales de los que admite la moneda (JPY 0, KWD 3, la mayoría 2).
curl "https://api.qvard.com/api/v1/rates?currencies=EUR,INR"
// 200 OK
{ "data": { "base": "USD", "updatedAt": "…", "rates": { "EUR": 0.92, "INR": … } } }Verifica firmas de webhook
Cada webhook de Qvard está firmado con HMAC-SHA256. Aprende cómo verificar la firma y protegerte contra falsificaciones con código listo para Node.js y PHP.
Preguntas frecuentes
A quick overview of how Qvard handles payments, integration and merchant operations.
¿Qué es Qvard?
Qvard es una pasarela de pagos cripto para empresas con checkout alojado, facturas, pagos por API y saldos de comercio.
¿Qué activos son compatibles?
Qvard admite USDT, USDC, BTC, LTC, TRX, BNB y ETH. TON y USDT en TON llegarán pronto.
¿Es buena para desarrolladores?
Sí. Qvard incluye pagos por API, redirectUrl, webhooks, reintentos y registros de entrega.
¿Puedo personalizar el checkout?
El checkout admite logo del comercio, nombre de la tienda, color de botón y localización. Las URLs de retorno personalizadas llegarán pronto.
¿Qué necesito para empezar?
Crea una cuenta de comercio y completa la verificación del negocio. Después de probar una factura de prueba, conecta el checkout alojado o la API y empieza a aceptar pagos reales.
¿Cómo funcionan los retiros?
Los fondos se registran en los saldos del comercio, separados por activo y red. Puedes retirar de forma manual o configurar reglas de retiro para pagos automáticos.