Checkout hospedado ou checkout próprio para pagamentos em cripto
Checkout hospedado ou próprio para cripto: o que cada um é, por que a Qvard usa uma página hospedada, o que dá para personalizar e quando vale esperar um checkout próprio.
Todo serviço de pagamento enfrenta a mesma escolha de design: os clientes pagam em uma página que o provedor hospeda ou dentro de um checkout que você mesmo constrói? Para cripto a segunda opção é muito mais pesada do que para cartões. Este guia explica a diferença, por que a Qvard oferece hoje uma página hospedada, o que você ainda pode personalizar em torno dela e o que teria de existir para um checkout totalmente próprio fazer sentido.
Duas formas de receber um pagamento
- Checkout hospedado. Você cria um pagamento e envia o cliente para uma página que o provedor opera. O provedor mostra o endereço, o valor exato e o status; você recebe o resultado por notificação.
- Checkout próprio. O formulário de pagamento vive dentro do seu próprio site ou app. Você exibe os dados do pagamento, acompanha o status e trata cada situação a que o cliente pode chegar.
O checkout hospedado é mais rápido de lançar e traz menos risco. O próprio dá controle total do visual e do fluxo, ao custo de construir e manter tudo o que a página hospedada faz por você.
O que um checkout cripto precisa fazer
Um checkout de cartão basicamente coleta alguns campos e chama uma API. Um checkout cripto tem mais tarefas:
- mostrar um endereço de pagamento para o ativo e a rede escolhidos, com a rede ao lado;
- mostrar um valor exato, fixo por tempo suficiente para o cliente enviá-lo;
- deixar o cliente escolher um ativo e uma rede, e explicar a diferença;
- acompanhar o pagamento na blockchain, incluindo pagamentos a menor e tardios;
- tratar erros como a rede errada, com uma mensagem clara.
Em cada um desses pontos, um erro custa dinheiro ao cliente. É o argumento mais forte a favor de uma página hospedada.
Por que a Qvard funciona hoje com uma página hospedada
O fluxo de pagamento da Qvard é construído em torno da página hospedada. Você cria um pagamento com um único POST para https://api.qvard.com/api/v1/payment, e a resposta contém um redirectUrl, o endereço dessa página. O cliente escolhe ali o ativo e a rede, vê o endereço e o valor exato e paga; a cotação fica fixa por uma hora. Veja como funciona o redirectUrl no checkout cripto.
A API pública é pequena: cria um pagamento, verifica se um método de pagamento está pronto e envia um pagamento de saída. Ela não entrega um endereço de depósito para você exibir, e não tem rota para ler o status de um pagamento, então você não conseguiria acompanhar um pagamento a partir da sua própria página. O checkout incorporado está pronto, e os SDKs também; esta API ainda não suporta um checkout cripto totalmente próprio, com exibição de endereço e consulta de status por conta própria.
O que você ainda pode desenhar
A página hospedada faz a parte difícil. A experiência ao redor dela é sua:
- A etapa anterior. A opção «Pagar com cripto», a explicação do que vai acontecer, as taxas e a regra de reembolso, nas suas palavras e no seu design.
- A etapa posterior. Uma página de pedido que mostra o status real (aguardando, a menor, pago), se atualiza enquanto espera e diz ao cliente o que fazer depois. Ainda não há URLs de retorno, então é por essa página que o cliente volta.
- Mensagens. O e-mail que você envia quando o pedido é feito, é pago ou fica com pagamento a menor.
- Lógica de negócio. Quais status liberam mercadoria, o que você faz com um pagamento a menor, como faz o reembolso.
Bem feito, o cliente vê uma loja consistente com uma página de pagamento no meio, e é disso que a maioria dos lojistas precisa.
Como escolher
- Escolha o checkout hospedado se quer lançar logo, se sua equipe é pequena, se não quer ser responsável pelos casos extremos da blockchain, ou se simplesmente precisa que funcione. É o que a Qvard suporta hoje.
- Use o checkout incorporado se uma experiência fluida dentro da página é essencial para o seu produto. Ele usa a mesma lógica de fatura da página hospedada, então a lógica de pedidos, o webhook e a página de pedido seguem sem mudanças.
- Não construa sua própria geração e varredura de endereços para obter um visual próprio. É a forma mais pesada e arriscada de comprar um design.
Seja qual for a sua escolha, a parte do servidor é a mesma: criar um pagamento com o número do pedido como id, marcar o pedido como pago apenas a partir do webhook (exatamente HTTP 200, seguro se for executado duas vezes) e conciliar. Veja como aceitar pagamentos em cripto em um site e API de pagamentos em cripto para desenvolvedores. Uma fatura de demonstração mostra a página hospedada.
FAQ
Posso incorporar o formulário de pagamento da Qvard na minha própria página?
Sim. O checkout incorporado abre a janela de pagamento da Qvard sobre a sua página, como modal ou bloco integrado. A página de pagamento hospedada continua disponível.
Posso mostrar o endereço de pagamento na minha própria página?
A API não devolve um endereço de depósito para você exibir, e não tem rota para ler o status do pagamento, então o endereço e o estado ficam na página hospedada.
O que posso personalizar?
As etapas antes e depois da página de pagamento: a escolha no checkout, as explicações, a página de status do pedido e seus e-mails, além da sua própria lógica de negócio.
Migrar depois para um checkout incorporado vai quebrar minha integração?
Planeje para que a parte do servidor continue igual: criar o pagamento com o id do seu pedido, marcar pedidos como pagos a partir do webhook e conciliar. Só mudaria a parte de front-end em torno do pagamento.
