SDK JavaScript para checkout cripto: previsto e funcionando hoje
SDK JavaScript para checkout cripto explicado: um script previsto que abre a janela de pagamento, o que está no roteiro da Qvard e o que funciona hoje.
Um SDK JavaScript para checkout cripto abriria uma janela de pagamento com algumas linhas de código no seu site. O Low-Code SDK da Qvard está no roteiro e ainda não foi lançado. Este guia explica a ideia e mostra o fluxo v1 real que você pode usar agora.
O que faz um SDK de checkout
Um SDK de checkout é uma pequena biblioteca JavaScript que o site carrega para iniciar um pagamento. Ela desenha a janela de pagamento, conduz o cliente pelas etapas e devolve o status à página. A lógica do pedido fica no servidor do lojista.
Status: o SDK está no roteiro
O Low-Code SDK da Qvard ainda não foi lançado, e este artigo não o descreve como uma biblioteca pronta. O trecho abaixo é uma prévia da chamada planejada, não um código que você pode rodar hoje.
O que funciona hoje
Crie o pagamento no seu servidor com POST /api/v1/payment e o cabeçalho x-api-key, redirecione o cliente para o redirectUrl devolvido na página de checkout hospedada e receba o status final por webhook. É o equivalente funcional da chamada prevista do SDK.
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
}A chamada no servidor
Envie o id do pedido em id e o preço em USD em price. Guarde a chave da API no servidor; o navegador recebe apenas o redirectUrl que o servidor devolve.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });A chamada prevista do SDK
Espera-se que o SDK do roteiro abra o mesmo fluxo de pagamento a partir da página com uma única chamada. O nome do método e as opções podem mudar antes do lançamento, então não desenvolva sobre a prévia ainda.
Como se preparar
Mantenha a criação do pagamento em uma função do backend e o manipulador de webhook separado. Quando o SDK for lançado, só a chamada do front-end muda; a chamada ao servidor e o webhook continuam os mesmos.
FAQ
Existe hoje um SDK JavaScript de checkout da Qvard?
Não. O Low-Code SDK está no roteiro. Hoje o mesmo resultado vem da API, da página de checkout hospedada e do webhook.
Posso usar a chamada QvardCheckout.open() agora?
Não. Ela aparece apenas como prévia da API planejada. Use POST /api/v1/payment e redirecione para o redirectUrl.
Preciso de uma biblioteca JavaScript para aceitar cripto hoje?
Não. Um botão comum que chama o seu backend e redireciona para o redirectUrl basta; o webhook confirma o pagamento.
Como testar o fluxo?
Crie uma fatura de demonstração e confirme que o seu webhook recebe o status final.
