Pagos cripto con código QR: cómo un código escaneado lleva al pago
Pagos cripto con código QR explicados: cómo un código escaneado lleva a la página de pago, qué prevé Qvard para el QR en el terminal y qué funciona hoy.
Los pagos cripto con código QR permiten que el cliente escanee un código con su billetera y pague en criptomonedas. Qvard prevé el pago por QR en su terminal POS, que todavía no se ha publicado. Esta guía explica cómo el escaneo lleva al pago y qué funciona hoy: un código QR que apunta a la página de pago alojada.
Qué contiene el código QR
Un código QR es la imagen de un enlace. Cuando el cliente lo escanea, la billetera o el teléfono abren el enlace, y el enlace lleva a la página de pago de esa venta concreta.
Estado: el QR en el terminal está en la hoja de ruta
Un terminal de Qvard que muestre su propio código QR no se ha publicado. Este artículo no lo presenta como disponible. El flujo por QR de abajo funciona hoy, porque el código codifica el redirectUrl que devuelve la API.
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 el redirectUrl y lo codifica como código QR. El cliente lo escanea, abre la página alojada y paga, y el webhook entrega el estado final.
Codifica solo el redirectUrl
Pon solo el redirectUrl en el código. No incluyas la clave de API, el total ni ningún secreto en el código QR, porque quien lo vea podrá leerlo.
Muestra el importe junto al código
Muestra el total en USD junto al código QR. La página alojada enseña después el importe exacto en la criptomoneda elegida a un tipo de cambio fijo, para que el cliente pueda compararlos.
Confirma por webhook
Un código escaneado no prueba el pago. Marca la venta como pagada solo cuando el webhook entregue el id y el estado paid.
FAQ
¿Muestra Qvard hoy un código QR en el terminal?
No desde un terminal dedicado, que está en la hoja de ruta. Hoy tu propia caja puede generar un código QR a partir del redirectUrl.
¿Puedo poner la clave de API en el código QR?
Nunca. El código QR debe llevar solo el redirectUrl, que es seguro compartir.
¿Basta un código QR escaneado para confirmar el pago?
No. Confirma el pago solo por webhook con el estado paid.
¿Cómo pruebo el código QR?
Crea una factura de demostración, codifica su redirectUrl y escanéalo con una billetera de prueba.
