Modal sobre tu páginaPróximamente
La ventana de pago se abre sobre la página actual, así el cliente conserva su lugar en el carrito.
Checkout integrado
Checkout integrado en tu sitio
La ventana de pago se abre sobre tu página como modal, así el cliente nunca sale de la tienda. La misma lógica de factura que la página de pago alojada.
Modal en tu páginaLa misma lógica de facturaEstado por webhook
Cómo funciona
De la factura al estado final
Tu página abre la ventana de pago con una factura creada por API.
El cliente paga dentro del modal, sin redirección.
El estado final llega por webhook y el modal se cierra.
Funciones
Qué obtienes
La misma lógica de facturaPróximamente
Importe, activo, red y tipo de cambio fijo funcionan exactamente igual que en la página de pago alojada.
Estado por webhook
El estado del pedido llega desde el webhook final, no desde el estado de la ventana del navegador.
Funciona en cualquier sitioPróximamente
Basta una llamada de script para abrir la ventana de pago en tu tienda.
Otras formas de cobrar
Otras formas de aceptar pagos
Qvard ofrece varios productos de pago. Elige el que encaje con tu canal de ventas.
FAQ
Preguntas frecuentes
A quick overview of how Qvard handles payments, integration and merchant operations.
¿Qué es Qvard?
Qvard es una pasarela de pagos cripto para empresas con checkout alojado, facturas, pagos por API y saldos de comercio.
¿Qué activos son compatibles?
Qvard admite USDT, USDC, BTC, LTC, TRX, BNB y ETH. TON y USDT en TON llegarán pronto.
¿Es buena para desarrolladores?
Sí. Qvard incluye pagos por API, redirectUrl, webhooks, reintentos y registros de entrega.
¿Puedo personalizar el checkout?
El checkout admite logo del comercio, nombre de la tienda, color de botón y localización. Las URLs de retorno personalizadas llegarán pronto.
¿Qué necesito para empezar?
Crea una cuenta de comercio y completa la verificación del negocio. Después de probar una factura de prueba, conecta el checkout alojado o la API y empieza a aceptar pagos reales.
¿Cómo funcionan los retiros?
Los fondos se registran en los saldos del comercio, separados por activo y red. Puedes retirar de forma manual o configurar reglas de retiro para pagos automáticos.
Inicio rápido
Integra el widget de checkout de Qvard de tres formas:
Tu clave pública (qvard_pk_…) puede estar en el código de tu página. Solo puede crear pagos para tu tienda—no lee datos ni retira fondos. Funciona solo desde dominios en tu Allowed origins, y tiene un límite de velocidad.
¿Necesitas que tu servidor calcule el monto o verifique el inventario? Usa la pestaña "Vía tu servidor": tu backend crea el pago con la clave secreta (qvard_sk_…), y solo la URL del pago va al navegador.
<script src="https://qvard.com/checkout.js"></script> <script> // 1. Describe el pago var checkout = new QvardCheckout({ mode: 'modal', publishableKey: 'qvard_pk_YOUR_PUBLISHABLE_KEY', price: 10, orderId: 'order-123', onSuccess: function (e) { // 3. Maneja el resultado console.log('paid', e.paymentId); }, onError: function (err) { console.log(err.code); } }); // 2. Crea y muestra la ventana checkout.open(); </script>
# Crea el pago en tu servidor curl -X POST https://api.qvard.com/api/v1/payment \ -H 'x-api-key: qvard_sk_YOUR_SECRET_KEY' \ -H 'Content-Type: application/json' \ -d '{"price":10,"id":"order-123"}' # Respuesta: {"id":"...","redirectUrl":"https://my.qvard.com/pay/..."} // Abre la ventana de pago en el navegador <script src="https://qvard.com/checkout.js"></script> <script> // 1. Describe el pago var checkout = new QvardCheckout({ mode: 'modal', paymentUrl: 'https://my.qvard.com/pay/...', // Toma redirectUrl de la respuesta del servidor onSuccess: function (e) { // 3. Maneja el resultado console.log('paid', e.paymentId); } }); // 2. Crea y muestra la ventana checkout.open(); </script>
<div id="checkout"></div> <script src="https://qvard.com/checkout.js"></script> <script> // 1. Describe el pago var checkout = new QvardCheckout({ mode: 'inline', target: '#checkout', publishableKey: 'qvard_pk_YOUR_PUBLISHABLE_KEY', price: 10, onSuccess: function (e) { // 3. Maneja el resultado console.log('paid', e.paymentId); } }); // 2. Crea y muestra la ventana checkout.open(); </script>
Referencia completa de la API: api.qvard.com/doc
Opciones de configuración
| Opción | Descripción |
|---|---|
| mode | modal | inline |
| target | Selector CSS o elemento DOM (solo modo inline) |
| publishableKey | Tu clave pública—requerida para crear pagos desde el navegador |
| paymentId | UUID de un pago pre-creado—requerido para flujo servidor |
| paymentUrl | URL completa del pago desde la respuesta del servidor—requerida para flujo servidor |
| price | Cantidad en USD (requerida con publishableKey) |
| orderId | Tu ID de transacción (opcional, máx 128 caracteres, se genera automáticamente si se omite) |
| paymentSystemId | ID del método de pago (opcional, desde tu configuración) |
| locale | Idioma de la página de pago: en, ru, es, pt, tr, id, vi, fr, de (por defecto el idioma del navegador) |
| theme | light | dark (opcional) |
| onSuccess | Callback cuando el pago tiene éxito: function(e) { console.log(e.paymentId); } |
| onClose | Callback cuando el usuario cierra la ventana sin pagar |
| onError | Callback en caso de error: function(err) { console.log(err.code, err.message); } |
Códigos de error: invalid_mode, invalid_target, invalid_options, invalid_payment_url, network_error, invalid_key, origin_not_allowed, duplicate_order, rate_limited, invalid_request, payment_failed.
Pruébalo en vivo
Prueba el widget con un pago de demostración real antes de integrarlo.
Ir al playground