E-commerce
Um checkout que diz a verdade ao seu sistema de pedidos.
Para lojas que vendem produtos físicos ou digitais: crie uma intenção de pagamento quando o carrinho estiver fechado, redirecione para o checkout hospedado e entregue apenas com um evento confirmado e assinado.
Fluxo
Como funciona, passo a passo.
- Sua loja
Carrinho fechado
Crie uma intenção de pagamento com o ID do seu pedido e o valor na sua moeda.
merchant_order_id - Cliente
Checkout hospedado
O cliente escolhe um ativo e vê o valor exato e o endereço deste pagamento, válidos por um período fixo.
/c/{session} - GRYPHEM
Pagamento observado
Os estados detectado e confirmando são atualizados ao vivo na página de checkout conforme o Bitcart os informa.
detected · confirming - Sua loja
Entregue quando confirmado
Um webhook payment.confirmed assinado marca o pedido como pago. Deduplique pelo event_id antes de enviar.
payment.confirmed - Sua equipe
Trate as exceções
Pagamentos a menor, a maior e atrasados caem na fila de revisão do painel com as evidências anexadas.
review_required
Resultados
O que muda para a sua equipe.
Estados do pedido ligados aos estados do pagamento
Cada estado de pagamento tem um significado preciso, então seu sistema de pedidos nunca precisa adivinhar se “visto” significa “pago”.
Sem entrega em dobro
Os IDs de evento são estáveis entre novas tentativas. Trate-os como chaves de idempotência e um webhook repetido se torna inofensivo.
Progresso honesto para os clientes
O checkout mostra cada etapa conforme acontece — detectado, confirmando, confirmado — em vez de um indicador de carregamento sem fim.
Reembolsos continuam nas suas mãos
Cripto não tem chargeback. Você decide sobre os reembolsos, envia-os de uma carteira que você controla e os registra no pagamento para a conciliação.
Antes de integrar
O que decidir de antemão.
- Pagamentos em cripto não têm chargeback. Sua política de reembolso deve dizer como e em qual ativo os reembolsos são feitos.
- Escolha uma janela de pagamento adequada ao seu checkout: longa o bastante para a confirmação na carteira, curta o bastante para limitar a variação de preço.
- Decida como tratar pagamentos parciais. O painel permite resolvê-los com um motivo registrado, nunca em silêncio.
- Entregue quando o pagamento estiver confirmado, não apenas detectado. Para pedidos de alto valor, consulte o pagamento na API antes de enviar.