Janela popup de pagamento cripto: como funciona e o que está previsto
Janela popup de pagamento cripto explicada: como funciona, o que o SDK da Qvard prevê para ela e o que você pode rodar hoje. Com código. Com exemplos.
Uma janela popup de pagamento cripto é uma janela de pagamento que abre sobre a página atual, de modo que o cliente paga sem sair do site. A janela está prevista como parte do SDK da Qvard e ainda não foi lançada. Este guia explica como ela funciona e o que você pode rodar hoje com a API.
Como funciona uma janela de pagamento
A página chama uma função, uma janela abre sobre o conteúdo, o cliente conclui o pagamento nela e a janela fecha. A loja fica em segundo plano e o pedido é confirmado no servidor.
Status: a janela está no roteiro
A janela popup de checkout da Qvard não foi lançada, e este artigo não a descreve como recurso pronto. O código na mídia é uma prévia da chamada planejada.
O que funciona hoje
Crie o pagamento com POST /api/v1/payment e o cabeçalho x-api-key, e redirecione o cliente para o redirectUrl da página de checkout hospedada. Receba o status final por webhook. Assim o cliente tem o mesmo resultado de pagamento, sem janela popup.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Abrir uma nova janela com cuidado
Se preferir uma janela separada, abra o redirectUrl em uma nova aba somente após um clique. Os navegadores bloqueiam janelas abertas sem ação do usuário, então o clique deve vir primeiro.
Confirme o pagamento no servidor
A janela, quando chegar, mostrará o progresso na página, mas o status pago deve continuar vindo do webhook. Construa desde já a lógica do pedido em torno do webhook.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });O que evitar
Não trate uma janela fechada como pagamento falho e não marque o pedido como pago ao fechá-la. Aguarde o resultado do webhook.
FAQ
Existe hoje uma janela popup de pagamento da Qvard?
Ainda não. A janela está prevista como parte do SDK, no roteiro. Hoje basta a página de checkout hospedada ou uma nova aba.
A janela pode abrir sem clique?
Os navegadores costumam bloquear. Abra a página de pagamento depois de um clique do usuário.
E se o cliente fechar a janela?
Não decida o resultado pelo evento de fechamento. Consulte o status do pedido pelo webhook.
Como testar o fluxo?
Crie uma fatura de demonstração e confira o resultado do webhook.
