API de faturas cripto com checkout hospedado
Crie faturas cripto programaticamente, receba um link de checkout hospedado para cada pagamento e receba webhooks de status final com taxa fixa por fatura.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR"
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}API de faturas cripto
- Mapeamento de externalId
- redirectUrl na resposta
- Webhook no status final
x-api-key: sk_live_…
{
"id": "order_1024",
"status": "paid"
}1 requisição, 1 redirecionamento, 1 webhook
Crie um pagamento, redirecione o cliente e processe o webhook final: toda a integração cabe em uma página.
Crie o pagamento com externalId, valor, moeda e URLs.
Redirecione o cliente para data.redirectUrl.
Receba o webhook de status final: wait, processing, completed ou rejected.
Cobre na sua moeda, contabilize em USD
Informe o valor em qualquer moeda ISO-4217 pelo campo currency, por exemplo INR, RUB ou EUR. Sem ele, o valor é em USD, como antes.
- A taxa de câmbio da Qvard é fixada uma vez, na criação do pagamento. O pagador vê o valor na sua moeda e o valor no token com que paga; o pagamento é registrado em USD.
- Os limites são verificados em USD após a conversão. Se o valor estiver fora da faixa, o erro mostra o limite na sua moeda.
- As taxas atuais estão na página de taxas e na API: GET /api/v1/rates, sem chave. Nas configurações da sua loja você pode definir a sua própria taxa para cada moeda.
- Erros: 422 unsupported_currency — moeda não suportada; 422 rate_unavailable — não há taxa; 422 invalid_amount_precision — mais casas decimais do que a moeda admite (JPY 0, KWD 3, a maioria 2).
curl "https://api.qvard.com/api/v1/rates?currencies=EUR,INR"
// 200 OK
{ "data": { "base": "USD", "updatedAt": "…", "rates": { "EUR": 0.92, "INR": … } } }Verifique assinaturas de webhook
Cada webhook do Qvard é assinado com HMAC-SHA256. Aprenda como verificar a assinatura e se proteger contra falsificações com código pronto para Node.js e PHP.
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.