Conceitos de checkout
Entenda a jornada do comprador, os resultados de pagamento e o acompanhamento após o checkout.
No checkout, o comprador revisa a oferta, preenche os dados de faturamento e realiza ou inicia um pagamento. Ele pode criar uma fatura, um pagamento e uma assinatura quando a oferta é recorrente.
Finalidade
Escolha Links de pagamento para compartilhar uma oferta reutilizável. Escolha Cart Checkout quando seu backend prepara um carrinho específico.
Um link de pagamento cria ou retoma uma Checkout Session quando o comprador inicia o fluxo interativo. Uma integração por API cria a sessão diretamente, com preços do catálogo ou inline. Ambos usam o mesmo checkout hospedado e fluxo de cobrança.
O que o checkout faz
- Mostra oferta, quantidades e valores devidos agora e depois.
- Coleta os dados do cliente e de faturamento.
- Mostra formas disponíveis para o carrinho, país, moeda e conexões habilitadas.
- Inicia o pagamento e cria os registros comerciais correspondentes.
- Mostra resultado, instruções ou a próxima ação necessária.
Resultados principais
| Resultado | Significado | Acompanhamento |
|---|---|---|
| Concluído | O comprador terminou o checkout; o pagamento pode ter sido concluído ou não exigir cobrança imediata. | Confira o status do pagamento e o evento correspondente. |
| Pendente | O fluxo foi enviado, mas falta confirmação ou uma ação para concluir o pagamento. | Siga as instruções e espere o resultado final. |
| Com falha | O pagamento não foi concluído por recusa, dados inválidos ou outro erro de processamento. | Confira a causa antes de tentar novamente ou escolher outra forma. |
O status da Checkout Session descreve o fluxo do comprador; paymentStatus descreve o pagamento. Um redirecionamento ou página concluída não comprova cobrança. Sua integração deve verificar e deduplicar o evento assinado invoice.paid antes de entregar uma compra paga.
Tipos de oferta
- Pagamento único: cobra um valor uma vez; uma oferta com valor zero não exige cobrança.
- Assinatura: pode cobrar a primeira fatura, iniciar um período de teste ou usar cobrança posterior por fatura, conforme a configuração.
- Carrinho misto: pode combinar taxa de adesão, assinaturas e testes com valores devidos imediatamente. Confira o que se paga agora e o que será faturado depois.
Dados do cliente
Conforme a oferta, o checkout pode pedir nome, email, endereço de faturamento, país, código postal e campos personalizados. Os dados identificam o cliente, permitem faturar e direcionar o pagamento e ajudam no acompanhamento.
Formas de pagamento
As formas disponíveis dependem do país e moeda selecionados, gateways configurados e famílias de formas habilitadas. Uma forma disponível para uma oferta ou rota pode não estar disponível para outra.
País e moedas disponíveis
Uma moeda deve ser compatível com todo o carrinho e com uma rota de pagamento habilitada para o país selecionado. Se um produto não aceitar USD, o carrinho não pode oferecer USD nessa compra.
O checkout pode escolher a rota inicial pelo país estimado do comprador, como ARS na Argentina ou BRL no Brasil. Isso não comprova que outras moedas estão desabilitadas.
Use o seletor de país no rodapé para mudar a rota. Se um país tiver várias moedas válidas, escolha a opção correspondente, como Argentina (ARS) ou Argentina (USD).
Se faltar uma moeda, confira os preços de todos os produtos e a rota da conta para esse país e moeda antes de pedir outra tentativa ao comprador.
Preços, descontos e totais
Confira preços, quantidades, descontos de produto, promoções, cupons, total devido agora e valores recorrentes futuros. Um teste pode adiar algumas cobranças enquanto outros itens são pagos imediatamente. Benefícios configurados dependem da elegibilidade; a cotação final determina quais se aplicam.
Checkout e faturas
Uma fatura registra o valor devido. Pagamentos descrevem a cobrança e uma assinatura registra a relação comercial recorrente. Uma fatura pode ser paga imediatamente, depois ou por acompanhamento de cobrança.
Criação de assinaturas
O status inicial depende da oferta: um teste pode começar como trialing; a primeira cobrança automática com falha pode deixá-la incomplete; um pagamento estabelecido pode ativá-la; a cobrança por fatura pode iniciar uma assinatura active sujeita aos vencimentos. Consulte Assinaturas.
O que o comprador pode ver
Pode ver confirmação imediata, um teste sem cobrança hoje, pagamento posterior ou instruções adicionais para um pagamento pendente. Formas com redirecionamento, transferências e pagamentos em dinheiro ou boleto podem terminar após o comprador sair do checkout.
Acompanhamento operacional
Confira separadamente envio do checkout, pagamento concluído, criação da assinatura e saldo da fatura. Uma compra gratuita ou de teste não comprova cobrança. Use Acompanhamento de cobranças para investigar pagamentos pendentes ou com falha.
Após o checkout
Confirme fatura, resultado do pagamento e assinatura separadamente. Em uma integração, use webhooks verificados em vez do resultado do navegador para confirmar uma compra paga.