API de pagos cripto: pagos servidor a servidor
Guía de la API de pagos cripto: crea un pago desde tu servidor con POST /api/v1/payment, obtén un redirectUrl y recibe el estado final por webhook.
Una API de pagos cripto permite que tu backend cree un pago, envíe al cliente a una página de pago alojada y conozca el estado final sin construir infraestructura blockchain propia. Qvard ofrece este flujo como Host-to-Host API v1.
Qué hace una API de pagos cripto
Una API de pagos cripto convierte un evento de compra en tu servidor en una solicitud de pago. Tu backend envía el id de tu pedido y el importe en tu moneda (USD por defecto), y la pasarela devuelve un redirectUrl a la página de pago alojada, donde el cliente elige activo y red. Las direcciones, los tipos de cambio y la monitorización de la blockchain quedan del lado de la pasarela.
Cómo es la solicitud v1 de Qvard
La llamada es un único POST a /api/v1/payment con la cabecera x-api-key. El campo id lleva tu propio id de transacción y price el importe en la moneda del campo currency opcional (ISO-4217, USD por defecto). paymentSystemId es opcional y elige un método de pago cuando lo necesitas. La respuesta devuelve el id del pago y el redirectUrl.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR",
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Servidor a servidor, no navegador a pasarela
La solicitud sale de tu backend, así que la clave de API nunca llega al navegador. El cliente solo ve la página de pago alojada después de que lo rediriges. Además, compruebas cada pedido en tu lado antes de crear el pago.
El estado final llega por webhook
La respuesta de la API confirma que el pago se creó, no que se pagó. El estado final se entrega a tu URL de webhook como un POST con los campos id y status, así que la lógica del pedido debe actuar según el webhook.
Qué revisar antes de salir en vivo
Guarda el id del pago junto al pedido, haz que el manejador del webhook sea seguro si se ejecuta dos veces y prueba todo el flujo con una factura de demostración. Usa el mismo id en cada solicitud de un pedido para poder conciliar las llamadas repetidas.
Comisiones y redes
La tarifa base es del 1% por pago y baja de forma individual hasta el 0,1% a medida que crece tu volumen. La comisión de red se paga aparte en la red que elige el cliente. La página de tarifas recoge las condiciones vigentes.
FAQ
¿Es una API de pagos cripto lo mismo que un enlace de pago?
No. Un enlace de pago es una página para compartir en ventas manuales. La API crea el pago desde tu sistema y devuelve un redirectUrl que controla tu código.
¿Necesito ejecutar un nodo de blockchain?
No. Qvard monitoriza las redes y envía el estado final por webhook, así que no ejecutas nodos ni escáneres tú mismo.
¿En qué moneda se indica el precio?
El campo price va en la moneda de currency (ISO-4217, por ejemplo INR o EUR); sin ese campo, va en USD. El cliente paga en el activo y la red que elige en la página de pago.
¿Puedo probarlo antes de salir en vivo?
Sí. Crea una factura de demostración y verás la misma página de pago alojada que verán tus clientes.
