Aceptar cripto en tienda física: cómo puede cobrar cripto un local hoy
Cómo aceptar cripto en una tienda física: el flujo de venta en caja, qué prevé el terminal de Qvard y el camino que funciona hoy con la API.
Aceptar cripto en una tienda significa que el cliente paga en el mostrador con una billetera en lugar de con tarjeta. Qvard prevé un terminal POS para esto, y todavía no se ha publicado. Esta guía explica el flujo de venta y el camino que funciona hoy: la caja crea el pago y el cliente paga en la página alojada.
El flujo de venta en tienda
El cajero introduce el total, la caja muestra un código de pago, el cliente lo escanea con una billetera y la venta se confirma. Los pasos son sencillos, pero la caja debe saber cuándo el pago es definitivo.
Estado: el terminal POS está en la hoja de ruta
Un terminal dedicado de Qvard para tiendas no se ha publicado, y este artículo no lo presenta como disponible. El flujo de venta de abajo funciona hoy con la API, la página alojada y el webhook.
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
}Qué funciona hoy
La caja crea el pago con POST /api/v1/payment y la cabecera x-api-key, recibe un redirectUrl y lo muestra como código QR o enlace. El cliente paga en la página alojada, y el webhook devuelve el estado final a la caja.
Muestra el total antes del pago
Muestra el importe en USD en el mostrador antes de que el cliente escanee. La página alojada enseña después el importe exacto en cripto a un tipo de cambio fijo para el activo y la red elegidos.
Gestiona el estado en el mostrador
Mantén la venta pendiente en la caja hasta que el webhook entregue paid. El recibo impreso debe seguir al estado pagado, no a la palabra del cliente.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Planifica el terminal
Cuando salga el terminal dedicado cambiará el dispositivo del mostrador. El software de caja, los registros de pedidos y el manejo del webhook seguirán en su sitio.
FAQ
¿Puede una tienda aceptar cripto en el mostrador hoy?
Sí, con una caja que cree pagos por API y muestre el redirectUrl como código QR o enlace. El terminal dedicado está en la hoja de ruta.
¿Necesita el cliente una aplicación?
Necesita una billetera que admita el activo y la red elegidos. La página alojada guía el pago.
¿Cuándo es definitiva una venta?
Cuando el webhook entregue el id y el estado paid, no cuando el cliente enseña la pantalla de pago.
¿Cómo pruebo en una tienda?
Crea una factura de demostración desde una caja de prueba y confirma que el webhook marca la venta antes de salir en vivo.
