Pagos cripto para SaaS
Deja que los clientes paguen cada periodo de facturación en USDT y otras criptomonedas. Creas un pago por factura mediante la API, envías el enlace y prolongas el acceso cuando el webhook indica que el pago está completo.
- Una factura por periodo de facturación
- Un pago por factura mediante la API
- Acceso prolongado por webhook
Cuándo encaja la cripto en un negocio SaaS
La cripto es una segunda forma de pago, junto a las tarjetas, para los clientes a los que fallan los carriles de tarjeta:
- equipos en países que tu procesador de tarjetas no atiende, o cuyas tarjetas se rechazan para software extranjero;
- empresas que prefieren pagar una factura anual grande por transferencia en lugar de con tarjeta;
- compradores de herramientas para desarrolladores, infraestructura y hosting que ya poseen stablecoins en dólares.
El remitente no puede revertir un pago cripto, así que estas facturas no tienen contracargos de tarjeta. Añade un método de pago; no sustituye la facturación con tarjeta para los demás.
El modelo: una factura por periodo de facturación
La facturación con tarjeta cobra automáticamente una tarjeta guardada. Un pago cripto lo tiene que iniciar el cliente, así que el modelo que funciona es una factura prepagada para cada periodo:
- Poco antes de que termine el periodo, tu sistema crea una factura y un pago de Qvard para ella.
- El cliente recibe un enlace a la página de pago alojada, elige un activo y una red y paga.
- Cuando el pago se completa, Qvard llama a tu webhook y prolongas la suscripción.
No hay método de pago guardado ni cobro automático. Qvard no ofrece facturación recurrente como producto, así que los recordatorios de renovación, el periodo de gracia y los cambios de plan son lógica tuya.
Cómo funciona
Crea el pago desde tu backend con un único POST a https://api.qvard.com/api/v1/payment: tu clave en la cabecera x-api-key, el número de tu factura como id y el importe como price, en dólares estadounidenses si no indicas currency, por ejemplo INR. La respuesta contiene un redirectUrl, la dirección de la página de pago alojada; ponla en el correo de la factura.
Cuando el pago se completa, Qvard envía un webhook con tu id y el estado completed. Comprueba la cabecera x-api-key, marca la factura como pagada solo si aún no lo está, responde exactamente HTTP 200 y prolonga la suscripción. El tipo de cambio de la página de pago queda fijado durante una hora.
// A few days before a period ends: create the invoice and its payment.
async function createRenewalInvoice(sub) {
const invoice = await db.invoices.create({ subscriptionId: sub.id, amountInr: sub.planPriceInr, status: 'open' });
const res = await fetch('https://api.qvard.com/api/v1/payment', {
method: 'POST',
headers: { 'x-api-key': process.env.QVARD_API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ id: String(invoice.id), price: invoice.amountInr, currency: 'INR' })
});
const { redirectUrl } = await res.json();
await mailer.send(sub.email, 'Your renewal invoice', 'Pay here: ' + redirectUrl);
}
// In the webhook handler, when status is "completed" (and the x-api-key header matches).
async function onPaid(invoiceId) {
const invoice = await db.invoices.markPaidIfOpen(invoiceId); // null if already paid
if (invoice) await db.subscriptions.extend(invoice.subscriptionId, '1 month');
}Qué queda de tu lado
Ten claro qué construyes tú y qué hace la pasarela por ti.
- Tú: facturas, recordatorios, el periodo de gracia, subidas y bajadas de plan, reembolsos y contabilidad.
- La pasarela: la página de pago, las direcciones, la vigilancia de la red, los estados de pago y el webhook.
Si un cliente paga solo una parte de la factura, el pago recibe el estado partial y no se envía el webhook de finalización; mantén la factura abierta y pide el resto. Todavía no hay URL de retorno tras el pago, así que da a los clientes una página de facturación que muestre el estado real de la factura.
Dinero y comisiones
No hay cuota de suscripción por la pasarela. La comisión es individual para tu proyecto y, según la página de precios, parte del 1% y puede bajar hasta el 0,1%. Los fondos quedan en tu saldo de Qvard y los retiras a tu propia billetera; el retiro cuesta solo la comisión de red. El retiro a una cuenta bancaria en moneda fiat no está disponible. Los precios siguen en dólares; los clientes pagan el equivalente en el activo y la red que elijan.
Qué está listo hoy
La integración es por la API, lo que requiere un desarrollador; todavía no hay un plugin de facturación listo, y los enlaces de pago y un sandbox independiente están en desarrollo. Lee la guía completa en pagos cripto para SaaS, el lado de facturación en facturación cripto para SaaS B2B y las reglas del webhook en cómo proteger los webhooks de pagos cripto. Los formatos de solicitud están en la documentación para desarrolladores, y una factura de demostración muestra lo que ve tu cliente.
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.