Terminal de pagos cripto: qué es y qué funciona hoy
Terminal de pagos cripto explicado: un dispositivo de punto de venta para pagos cripto, qué está en la hoja de ruta de Qvard y qué funciona hoy con la API.
Un terminal de pagos cripto es un dispositivo de punto de venta que acepta pagos en criptomonedas en el mostrador. Qvard tiene un terminal en la hoja de ruta y todavía no se ha publicado. Esta guía explica el concepto y el camino que funciona: un servidor de caja que crea pagos con la API v1 en vivo.
Qué hace un terminal de pagos cripto
Un terminal de pagos cripto muestra el importe, permite al cliente pagar con su billetera y confirma el resultado en pantalla. Sustituye al lector de tarjetas para negocios que quieren cobrar cripto en un mostrador físico.
Estado: el terminal está en la hoja de ruta
El terminal POS de Qvard no se ha publicado, y este artículo no lo describe como dispositivo terminado. El camino de abajo está disponible hoy mediante la API, la página de pago alojada y el webhook.
Qué funciona hoy
El servidor de caja crea un pago con POST /api/v1/payment y la cabecera x-api-key, y recibe un redirectUrl. El cliente paga en la página alojada a la que apunta el redirectUrl, y el webhook entrega el estado final.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}La llamada desde el servidor de caja
Envía el id de la venta como id y el total en USD como price. Guarda la clave de API en el servidor de caja. La respuesta devuelve el redirectUrl que la caja muestra al cliente.
Confirma la venta por webhook
La caja solo debe marcar la venta como pagada cuando el webhook entregue el id y el estado paid. Hasta entonces la venta queda pendiente, aunque el cliente diga que ya pagó.
Cómo prepararse para un terminal propio
Mantén la lógica de ventas y el webhook en el software de caja. Cuando salga un terminal dedicado cambiará el dispositivo, pero la creación del pago y el manejo del estado seguirán igual.
FAQ
¿Hay hoy un terminal de pagos cripto de Qvard?
Todavía no. El terminal POS está en la hoja de ruta. Hoy un servidor de caja usa la API, la página alojada y el webhook.
¿Puedo usar mi propio software de caja?
Sí. Cualquier software que pueda enviar un POST HTTPS y recibir un webhook puede crear pagos con la API.
¿Qué ve el cliente en el mostrador?
Hoy la caja muestra el redirectUrl como código QR o enlace, y la página de pago se abre en el dispositivo del cliente.
¿Cómo pruebo antes de una venta real?
Crea una factura de demostración, págala en la página alojada y comprueba que el webhook marca la venta.
