Como adicionar pagamentos cripto a uma loja online

Decida primeiro

Quatro decisões poupam retrabalho mais tarde.

1. Que ativos e redes. Comece pequeno: USDT e USDC cobrem a maioria dos clientes. A Qvard suporta USDT, USDC, BTC, LTC, TRX, BNB e ETH, nas redes TRC20, ERC20, BEP20, Bitcoin e Litecoin.
2. Preço em dólares. Mantenha os seus preços como estão. O pagamento é criado em dólares americanos e o valor cripto exato é mostrado na página de pagamento, com a taxa fixa por uma hora.
3. O que um pedido pago desencadeia. Envio, uma chave de licença, acesso a conteúdo. Decida o que acontece no momento em que o pagamento é concluído.
4. O que faz quando algo corre mal. Pagamentos curtos, reembolsos, um cliente que pagou pela rede errada. Escreva a regra agora.

Passos de integração

A Qvard ainda não tem plugins prontos para lojas, por isso uma loja integra-se pela API. São duas peças de código de servidor.

1. Crie um pagamento quando o cliente escolhe cripto. Um POST para https://api.qvard.com/api/v1/payment com o seu número de pedido como id e o total do pedido em dólares americanos como price, autenticado com a sua chave de API. A resposta contém um redirectUrl; envie o cliente para lá.
2. Receba o resultado. Guarde uma URL de callback no painel. Quando o pagamento é concluído, a Qvard envia um POST com o seu número de pedido e o estado. Marque o pedido como pago e desencadeie o cumprimento. Responda exatamente HTTP 200.
3. Torne o tratador seguro. Pode ser entregue mais de uma vez, por isso uma repetição não deve mudar nada.

As versões detalhadas: como aceitar pagamentos cripto num site para o fluxo genérico, WordPress e WooCommerce para essas plataformas, e a API de pagamentos cripto para programadores como referência.

Associe os estados aos do seu pedido

Um pagamento tem quatro estados: wait, partial, completed e rejected. O seu pedido precisa de estados correspondentes, e o webhook chega apenas com completed.

• Pedido criado e por pagar corresponde a wait.
• Um pagamento curto corresponde a partial: mantenha o pedido em espera e peça ao cliente a diferença.
• Um pedido pago corresponde a completed: cumpra-o.
• rejected: trate o pagamento como falhado e deixe o cliente tentar de novo.

A correspondência completa, com código, está em pagamentos cripto para e-commerce.

Redação no checkout

A maioria dos pedidos de suporte sobre cripto vem de textos pouco claros. No passo de pagamento:

• nomeie as moedas e redes aceites;
• diga que o valor tem de ser enviado por inteiro e pela rede indicada na página de pagamento;
• indique que a taxa fica fixa por uma hora;
• explique como funcionam os reembolsos e onde obter ajuda.

A Qvard ainda não oferece URLs de retorno, por isso o cliente chega à página de pagamento e você diz-lhe o que acontece a seguir. Uma página de pedido clara que se atualiza após o webhook, mais um e-mail de confirmação, substitui o redirecionamento.

Teste e entrada em produção

Ainda não há sandbox, por isso teste com pequenos valores reais.

1. Pague um pequeno valor real e acompanhe todo o percurso: pagamento criado, cliente pagou, webhook recebido, pedido marcado como pago.
2. Faça o endpoint falhar uma vez e confirme que a nova tentativa (cinco tentativas em cerca de seis minutos) não cumpre o pedido duas vezes.
3. Levante um pequeno valor para a sua carteira para verificar esse passo. Custa apenas a taxa de rede.
4. Acrescente cripto ao checkout e acompanhe os primeiros pedidos.

Depois do lançamento, mantenha uma rotina curta; a lista está em o checklist operacional para pagamentos cripto. Custo: sem mensalidade, e a comissão, individual para o seu projeto, começa em 1% e pode descer até 0,1% segundo a página de preços.

FAQ