Pular para o conteúdo
Criar conta
ou
Entrar
O logotipo da documentação da Stripe
/
Pergunte à IA
Criar conta
Login
Comece já
Pagamentos
Receita
Plataformas e marketplaces
Gestão de valores
Recursos para desenvolvedores
Visão geral
Sobre os pagamentos da Stripe
Atualize sua integração
Análise de pagamentos
Pagamentos online
Visão geralEncontre seu caso de usoPagamentos gerenciados
Usar Payment Links
Crie uma página de checkout
    Visão geral
    Inícios rápidos
    Personalizar a aparência
    Coletar informações adicionais
    Colete impostos
    Atualizar checkout dinamicamente
    Gerencie seu catálogo de produtos
    Assinaturas
    Gerenciar formas de pagamento
    Permita que os clientes paguem na moeda local
    Adicione descontos, upsells e itens opcionais
    Configurar pagamentos futuros
    Salvar dados de pagamento durante o pagamento
    Aprovar manualmente pagamentos no servidor
    Após o pagamento
      Executar pedidos
      Enviar recibos e faturas pagas
      Personalizar o comportamento de redirecionamento
      Recupere carrinhos abandonados
      Analisar funil de conversão
    Elements com changelog beta da API Checkout Sessions
    Migrar do Checkout antigo
    Migrar o Checkout para usar Prices
Criar uma integração avançada
Crie uma integração no aplicativo
Formas de pagamento
Adicionar formas de pagamento
Gerenciar formas de pagamento
Checkout mais rápido com o Link
Interfaces de pagamento
Payment Links
Checkout
Web Elements
In-app Payments
Cenários de pagamento
Gerenciar várias moedas
Fluxos de pagamento personalizados
Aquisição flexível
Orquestração
Pagamentos presenciais
Terminal
Muito mais que pagamentos
Abra sua empresa
Cripto
Financial Connections
Climate
Entenda as fraudes
Proteção contra fraudes do Radar
Gerenciar contestações
Verificar identidades
Página inicialPagamentosBuild a checkout pageAfter the payment

Personalizar comportamento de redirecionamento

Exiba uma página de confirmação com os dados do pedido do seu cliente.

Você pode personalizar como e se a Stripe redireciona os clientes após a conclusão do pagamento. É possível definir que a Stripe redirecione os clientes sempre ou só redirecionar para algumas formas de pagamento.

Para configurar redirecionamentos, especifique a página de retorno:

  • No return_url quando você cria a sessão do Checkout no seu servidor
  • No returnUrl quando você confirma a sessão do Checkout no cliente.

Ou você pode redirecionar os clientes somente se a forma de pagamento exigir ( por exemplo, uma página de autorização bancária para uma forma baseada em débito).

Os webhooks são necessários para a execução

Você não pode depender do acionamento do atendimento apenas na sua página de destino de checkout, pois não há garantia de que seus clientes acessarão essa página. Por exemplo, alguém pode pagar e perder a conexão com a Internet antes que sua página de destino carregue.

Configure um gerenciador de eventos de Webhook para que a Stripe envie eventos de pagamento diretamente ao seu servidor, ignorando totalmente o cliente. Os webhooks são a maneira mais confiável de confirmar quando você recebe pagamentos. Se a entrega de evento de Webhook falhar, a Stripe tentará novamente várias vezes.

Redirecionar clientes para uma página de retorno

Quando você criar a Checkout Session, especifique o URL da página de retorno no return_url. Você pode adicionar a variável de modelo {CHECKOUT_SESSION_ID} ao return_url para incluir o ID da sessão do Checkout concluída. Esta é uma cadeia de caracteres literal e você deve adicioná-la exatamente como você vê aqui. Não a substitua por um ID de sessão do Checkout, que acontece automaticamente depois que seu cliente paga e é encaminhado para a página de retorno.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d "line_items[0][price_data][currency]"=usd \ -d "line_items[0][price_data][product_data][name]"=T-shirt \ -d "line_items[0][price_data][unit_amount]"=2000 \ -d "line_items[0][quantity]"=1 \ -d mode=payment \ -d ui_mode=custom \ --data-urlencode return_url="https://example.com/return?session_id={CHECKOUT_SESSION_ID}"

Formas de pagamento baseadas em redirecionamento

Durante o pagamento, algumas formas de pagamento redirecionam o cliente para uma página intermediária, como uma página de autorização bancária. Quando concluem essa página, a Stripe os redireciona para sua página de retorno.

Para somente redirecionar o cliente para sua página de devolução se ele for redirecionado para uma página intermediária, defina redirect: 'if_required' quando confirmar a sessão do Checkout.

Esta página foi útil?
SimNão
  • Precisa de ajuda? Fale com o suporte.
  • Participe do nosso programa de acesso antecipado.
  • Confira nosso changelog.
  • Dúvidas? Fale com a equipe de vendas.
  • LLM? Read llms.txt.
  • Powered by Markdoc