Pagamentos em cripto para SaaS
Deixe os clientes pagarem cada período de cobrança em USDT e outras criptomoedas. Você cria um pagamento por fatura pela API, envia o link e estende o acesso quando o webhook indica que o pagamento foi concluído.
- Uma fatura por período de cobrança
- Um pagamento por fatura pela API
- Acesso estendido por webhook
Quando o cripto combina com um negócio SaaS
O cripto é uma segunda forma de pagar, ao lado dos cartões, para os clientes que as vias de cartão deixam na mão:
- equipes em países que seu processador de cartões não atende, ou cujos cartões são recusados para software estrangeiro;
- empresas que preferem pagar uma fatura anual grande por transferência em vez de cartão;
- compradores de ferramentas para desenvolvedores, infraestrutura e hospedagem que já têm stablecoins em dólar.
O remetente não pode reverter um pagamento em cripto, então essas faturas não têm chargebacks de cartão. Ele adiciona um meio de pagamento; não substitui a cobrança por cartão para os demais.
O modelo: uma fatura por período de cobrança
A cobrança por cartão debita automaticamente um cartão salvo. Um pagamento em cripto precisa ser iniciado pelo cliente, então o modelo que funciona é uma fatura pré-paga para cada período:
- Pouco antes do fim do período, seu sistema cria uma fatura e um pagamento da Qvard para ela.
- O cliente recebe um link para a página de pagamento hospedada, escolhe um ativo e uma rede e paga.
- Quando o pagamento é concluído, a Qvard chama seu webhook e você estende a assinatura.
Não há meio de pagamento salvo nem cobrança automática. A Qvard não oferece cobrança recorrente como produto, então lembretes de renovação, período de carência e mudanças de plano são lógica sua.
Como funciona
Crie o pagamento a partir do seu backend com um único POST para https://api.qvard.com/api/v1/payment: sua chave no cabeçalho x-api-key, o número da fatura como id e o valor como price, em dólares americanos se você não enviar currency, por exemplo INR. A resposta traz um redirectUrl, o endereço da página de pagamento hospedada; coloque-o no e-mail da fatura.
Quando o pagamento é concluído, a Qvard envia um webhook com o seu id e o estado completed. Confira o cabeçalho x-api-key, marque a fatura como paga somente se ainda não estiver paga, responda exatamente HTTP 200 e estenda a assinatura. A cotação na página de pagamento fica fixa por uma 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');
}O que fica do seu lado
Tenha claro o que você constrói e o que o gateway faz por você.
- Você: faturas, lembretes, período de carência, upgrades e downgrades, reembolsos e contabilidade.
- O gateway: a página de pagamento, os endereços, o monitoramento da rede, os estados de pagamento e o webhook.
Se um cliente pagar apenas parte da fatura, o pagamento recebe o estado partial e nenhum webhook de conclusão é enviado; mantenha a fatura aberta e peça o restante. Ainda não há URLs de retorno após o pagamento, então dê aos clientes uma página de cobrança que mostre o estado real da fatura.
Dinheiro e taxas
Não há mensalidade pelo gateway. A comissão é individual para o seu projeto e, segundo a página de preços, começa em 1% e pode chegar a 0,1%. Os fundos ficam no seu saldo da Qvard e você os saca para a sua própria carteira; o saque custa apenas a taxa de rede. O saque para conta bancária em moeda fiduciária não está disponível. Os preços continuam em dólares; os clientes pagam o equivalente no ativo e na rede que escolherem.
O que está pronto hoje
A integração é pela API, o que exige um desenvolvedor; ainda não há um plugin de cobrança pronto, e links de pagamento e um sandbox separado estão em desenvolvimento. Leia o guia completo em pagamentos em cripto para SaaS, o lado do faturamento em faturamento em cripto para SaaS B2B e as regras do webhook em como proteger webhooks de pagamentos em cripto. Os formatos de requisição estão na documentação para desenvolvedores, e uma fatura de demonstração mostra o que seu cliente vê.
FAQ
A quick overview of how Qvard handles payments, integration and merchant operations.
O que é o Qvard?
Qvard é um gateway de pagamentos cripto para empresas com checkout hospedado, faturas, pagamentos via API e saldos de merchant.
Quais ativos são suportados?
Qvard aceita USDT, USDC, BTC, LTC, TRX, BNB e ETH. TON e USDT na TON em breve.
É bom para desenvolvedores?
Sim. Qvard inclui pagamentos via API, redirectUrl, webhooks, novas tentativas e logs de entrega.
Posso personalizar o checkout?
O checkout suporta logo do merchant, nome da loja, cor do botão e localização. URLs de retorno personalizadas em breve.
O que é preciso para começar?
Crie uma conta de merchant e conclua a verificação do negócio. Depois de testar uma fatura de teste, conecte o checkout hospedado ou a API e comece a aceitar pagamentos reais.
Como funcionam os saques?
Os fundos são acompanhados nos saldos do merchant, separados por ativo e rede. Você pode sacar manualmente ou configurar regras de saque automático.