Botón de pago cripto: cómo añadirlo a tu sitio
Botón de pago cripto: cómo añadir un botón de pagar con cripto a tu sitio, qué es el botón previsto del SDK y qué funciona hoy. Con código. Paso a paso.
Un botón de pago cripto es un único botón en tu sitio que inicia un pago en criptomonedas. El SDK previsto de Qvard renderizaría ese botón con unas pocas líneas de código, pero todavía no está publicado. Esta guía muestra cómo crear hoy un botón que funcione con la API real.
Qué hace un botón de pago cripto
Un botón de pago inicia un pago cuando el cliente hace clic. En un sitio cripto el clic lleva a una página de pago donde el cliente elige activo y red. El botón en sí no guarda fondos ni claves.
Estado: el botón del SDK está en la hoja de ruta
El botón del SDK de Qvard todavía no está publicado. Este artículo no lo presenta como componente terminado, y el código de vista previa del medio está marcado como roadmap.
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
}Un botón que funciona hoy
El botón envía una solicitud a tu backend. El backend crea el pago con POST /api/v1/payment y la cabecera x-api-key, y devuelve el redirectUrl. El botón lleva allí al cliente y el webhook confirma el pago.
Colocar el botón en el checkout
Ponlo al final del carrito, junto al total. Muestra el importe en USD antes del clic para que el cliente sepa qué esperar en la página alojada.
Hacer el botón seguro
No pongas la clave de API en el código del botón. Crea el pago solo cuando el cliente haga clic y comprueba el total del pedido en el servidor, no en el navegador.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Confirmar con el webhook
Cuando el webhook entregue el id y el estado paid, marca el pedido como pagado. Un clic en el botón no significa que el dinero haya llegado.
FAQ
¿Hay hoy un componente de botón de pago de Qvard?
No como componente del SDK, que está en la hoja de ruta. Hoy un botón normal que llama a tu backend hace el mismo trabajo.
¿Puede el botón mostrar el importe en otra moneda?
El precio de la solicitud API va en USD. La página alojada muestra el importe exacto en el activo elegido a un tipo de cambio fijo.
¿Basta el botón sin webhook?
No. El botón solo inicia el pago. Marca el pedido como pagado únicamente desde el webhook.
¿Cómo pruebo el botón?
Usa un flujo con factura de demostración y comprueba que el webhook marca el pedido tras el pago.
