Criar um pagamento cripto e obter um redirectUrl
Como criar um pagamento cripto e obter um redirectUrl em uma única chamada de API: POST /api/v1/payment, cabeçalho x-api-key, valor na sua moeda (USD por padrão) e redirecionamento.
Criar um pagamento e obter um redirectUrl é uma única requisição na Host-to-Host API v1 da Qvard. Este guia cobre os campos da requisição, a resposta e como enviar o cliente ao checkout com segurança.
Os campos da requisição
Envie um POST para /api/v1/payment com o cabeçalho x-api-key. id é o seu identificador de transação, price é o valor na moeda indicada (USD por padrão), currency é um código ISO-4217 opcional como INR, RUB ou EUR, e paymentSystemId é opcional. Mantenha o id único por pedido, para associar a resposta ao seu registro. Uma moeda não suportada é recusada com 422 unsupported_currency, casas decimais demais para essa moeda com 422 invalid_amount_precision e moeda sem taxa de câmbio com 422 rate_unavailable.
Lendo a resposta
A resposta traz o id do pagamento e o redirectUrl, que aponta para a página hospedada em https://my.qvard.com/pay/ seguida do id do pagamento. Guarde os dois valores junto ao pedido antes de redirecionar o cliente.
Redirecionando o cliente
Envie o cliente ao redirectUrl com um redirecionamento HTTP comum ou com um link no seu site. Na página hospedada o cliente escolhe o ativo e a rede e vê o valor exato com taxa fixa.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR",
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Erros e novas tentativas
Se uma requisição falhar, confira os seus registros antes de reenviar, para que um pedido não gere dois pagamentos. Registre o corpo da resposta para o suporte e tente de novo apenas depois de confirmar que não há pagamento para aquele pedido.
Erros comuns
Não coloque o x-api-key no código do front-end, não trate o redirecionamento como confirmação de pagamento e não envie o preço em outra moeda que não seja a indicada no campo currency. O status final sempre chega por webhook.
Um pedido online, passo a passo
Quando o comprador clica em pagar, o seu servidor cria o pagamento com o id do pedido e o total do carrinho e depois redireciona o comprador para o redirectUrl. Quando o webhook informa que foi pago, você marca o pedido como pago.
FAQ
Preciso enviar o paymentSystemId?
Não. Ele é opcional. Envie quando quiser um método de pagamento específico; caso contrário, a página hospedada oferece as opções disponíveis.
Posso reutilizar um redirectUrl em outro pedido?
Não. Cada pagamento tem o seu próprio redirectUrl. Crie um pagamento novo para cada pedido.
O cliente pode pagar por um link que envio por e-mail?
Sim. O redirectUrl é uma página HTTPS comum, então funciona em um e-mail ou chat. Links de pagamento sem código pelo painel estão no roteiro.
Qual valor o cliente paga?
A página hospedada mostra o valor exato do ativo escolhido com taxa fixa durante a validade da fatura.
