Modal sobre a sua páginaEm breve
A janela de pagamento abre sobre a página atual, e o cliente mantém o lugar no carrinho.
Checkout incorporado
Checkout incorporado no seu site
A janela de pagamento abre sobre a sua página como um modal, e o cliente nunca sai da loja. A mesma lógica de fatura da página de pagamento hospedada.
Modal na sua páginaA mesma lógica de faturaStatus por webhook
Como funciona
Da fatura ao status final
Sua página abre a janela de pagamento com uma fatura criada via API.
O cliente paga dentro do modal, sem redirecionamento.
O status final chega por webhook e o modal fecha.
Recursos
O que você recebe
A mesma lógica de faturaEm breve
Valor, ativo, rede e taxa fixa funcionam exatamente como na página de pagamento hospedada.
Status por webhook
O status do pedido vem do webhook final, e não do estado da janela do navegador.
Funciona em qualquer siteEm breve
Basta uma chamada de script para abrir a janela de pagamento na sua loja.
Outras formas de receber
Outras formas de aceitar pagamentos
A Qvard oferece vários produtos de pagamento. Escolha o que combina com o seu canal de vendas.
FAQ
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.
Início rápido
Integre o widget de checkout do Qvard de três maneiras:
Sua chave pública (qvard_pk_…) pode estar no código da página. Ela só pode criar pagamentos para sua loja—não lê dados nem saca fundos. Funciona apenas de domínios no seu Allowed origins e tem limite de taxa.
Seu servidor precisa calcular o valor ou verificar o inventário? Use a aba "Via seu servidor": seu backend cria o pagamento com a chave secreta (qvard_sk_…), e apenas a URL do pagamento vai para o navegador.
<script src="https://qvard.com/checkout.js"></script> <script> // 1. Descreva o pagamento var checkout = new QvardCheckout({ mode: 'modal', publishableKey: 'qvard_pk_YOUR_PUBLISHABLE_KEY', price: 10, orderId: 'order-123', onSuccess: function (e) { // 3. Manipule o resultado console.log('paid', e.paymentId); }, onError: function (err) { console.log(err.code); } }); // 2. Crie e mostre a janela checkout.open(); </script>
# Crie o pagamento no seu 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"}' # Resposta: {"id":"...","redirectUrl":"https://my.qvard.com/pay/..."} // Abra a janela de pagamento no navegador <script src="https://qvard.com/checkout.js"></script> <script> // 1. Descreva o pagamento var checkout = new QvardCheckout({ mode: 'modal', paymentUrl: 'https://my.qvard.com/pay/...', // Obtenha redirectUrl da resposta do servidor onSuccess: function (e) { // 3. Manipule o resultado console.log('paid', e.paymentId); } }); // 2. Crie e mostre a janela checkout.open(); </script>
<div id="checkout"></div> <script src="https://qvard.com/checkout.js"></script> <script> // 1. Descreva o pagamento var checkout = new QvardCheckout({ mode: 'inline', target: '#checkout', publishableKey: 'qvard_pk_YOUR_PUBLISHABLE_KEY', price: 10, onSuccess: function (e) { // 3. Manipule o resultado console.log('paid', e.paymentId); } }); // 2. Crie e mostre a janela checkout.open(); </script>
Referência completa da API: api.qvard.com/doc
Opções de configuração
| Opção | Descrição |
|---|---|
| mode | modal | inline |
| target | Seletor CSS ou elemento DOM (apenas modo inline) |
| publishableKey | Sua chave pública—necessária para criar pagamentos do navegador |
| paymentId | UUID de um pagamento pré-criado—necessário para fluxo servidor |
| paymentUrl | URL completa do pagamento da resposta do servidor—necessária para fluxo servidor |
| price | Valor em USD (necessário com publishableKey) |
| orderId | Seu ID de transação (opcional, máx 128 caracteres, gerado automaticamente se omitido) |
| paymentSystemId | ID do método de pagamento (opcional, das suas configurações) |
| locale | Idioma da página de pagamento: en, ru, es, pt, tr, id, vi, fr, de (padrão é o idioma do navegador) |
| theme | light | dark (opcional) |
| onSuccess | Callback quando o pagamento é bem-sucedido: function(e) { console.log(e.paymentId); } |
| onClose | Callback quando o usuário fecha a janela sem pagar |
| onError | Callback em caso de erro: function(err) { console.log(err.code, err.message); } |
Códigos de erro: invalid_mode, invalid_target, invalid_options, invalid_payment_url, network_error, invalid_key, origin_not_allowed, duplicate_order, rate_limited, invalid_request, payment_failed.
Experimente ao vivo
Teste o widget com um pagamento de demonstração real antes de integrá-lo.
Ir para o playground