Sistema POS cripto: cómo un TPV puede cobrar cripto
Sistema POS cripto explicado: cómo un TPV puede aceptar cripto, qué prevé Qvard para su terminal POS y qué funciona hoy con la API. Con ejemplos.
Un sistema POS cripto es un software de punto de venta que cobra pagos en criptomonedas junto al efectivo y las tarjetas. Qvard prevé un terminal POS, que todavía no se ha publicado. Este artículo muestra cómo un TPV puede conectarse hoy a la API v1 en vivo y dónde encajaría después un terminal dedicado.
Qué necesita un sistema POS cripto
Un TPV necesita crear un pago por el total de la venta, mostrar un enlace escaneable y recibir el estado final para cerrar la venta. Lo demás, como recibos y stock, se queda en el software del TPV.
Estado: el terminal POS de Qvard está en la hoja de ruta
El terminal POS de Qvard no se ha publicado, y este artículo no lo presenta como dispositivo terminado. La integración de abajo funciona hoy con la API, la página alojada y el webhook.
La integración hoy
El software del TPV envía POST /api/v1/payment con la cabecera x-api-key, el id y el total de la venta, recibe un redirectUrl y lo muestra como código QR o enlace. Después el webhook devuelve el estado final para cerrar la venta en el TPV.
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
}Vincula la venta con el pago
Usa el id de la venta como id, para que cada pago esté ligado a exactamente una venta. El total en USD va en price.
Cierra la venta con el webhook
El TPV cierra la venta e imprime el recibo solo cuando el webhook entregue paid. Las ventas pendientes pueden mostrarse como en espera, para que el cajero sepa que el dinero aún no ha llegado.
Planifica la ruta de actualización
Cuando salga el terminal dedicado podrá asumir el paso del código QR. El software del TPV, los registros de ventas y el manejo del webhook no cambiarán.
FAQ
¿Puede mi software TPV aceptar cripto hoy?
Sí, si puede enviar un POST HTTPS, mostrar un código QR o enlace y recibir un webhook. El terminal POS de Qvard está en la hoja de ruta.
¿Qué campo vincula un pago con una venta?
El campo id lleva el id de tu venta, así cada pago corresponde a una venta de tu sistema.
¿El TPV necesita un plugin especial?
No. Cualquier TPV que pueda llamar a un endpoint REST y recibir un webhook puede integrarse con la API.
¿Cómo pruebo la integración del TPV?
Crea una factura de demostración desde una venta de prueba y confirma que el TPV cierra la venta al llegar el webhook.
