Pular para o conteúdo
Criar conta
 ou
Entrar
O logotipo da documentação da Stripe
/
Criar conta
Login
Visão geralAtualize sua integração
Pagamentos online
Visão geralEncontre seu caso de usoUsar o Managed Payments
Formas de pagamento
Interfaces de pagamento
Cenários de pagamento
Pagamentos presenciais
Muito mais que pagamentos

Personalizar comportamento de redirecionamento

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

Se você tiver uma integração com o Checkout que usa uma página hospedada pela Stripe, ela redirecionará seu cliente para uma página de finalização que você criou e hospeda no seu site. Você pode usar os dados de uma sessão do Checkout para exibir uma página de confirmação de pedido para o cliente (por exemplo, nome ou valor do pagamento) após o pagamento.

Redirecionar os clientes para uma página de sucesso

Para usar os detalhes de uma sessão do Checkout:

  1. Modifique o success_url para passar o ID da sessão do Checkout para o lado do cliente.
  2. Busque a Sessão do Checkout com o ID da sua página de finalização.
  3. Use a Sessão do Checkout para personalizar o conteúdo da página de finalização.

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.

Modificar o URL de sucesso Lado do servidor

Insira a variável de modelo {CHECKOUT_SESSION_ID} em success_url ao criar a Sessão do Checkout. Observe que essa string é literal e deve ser adicionada exatamente como está aqui. Não substitua por uma ID de Sessão de Checkout — isso acontecerá automaticamente depois que seu cliente pagar e for encaminhado para a página de finalização.

Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
session = Stripe::Checkout::Session.create(
  success_url: "http://yoursite.com/order/success",
  success_url: "http://yoursite.com/order/success?session_id={CHECKOUT_SESSION_ID}",
  # other options...,
)

Criar a página de sucesso Lado do servidor

Busque a sessão do Checkout usando o ID e crie uma página de sucesso mostrando os dados do pedido. Este exemplo também mostra o nome do cliente:

Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# This example sets up an endpoint using the Sinatra framework.


# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'


require 'sinatra'

get '/order/success' do
  session = Stripe::Checkout::Session.retrieve(params[:session_id])
  customer = Stripe::Customer.retrieve(session.customer)

  "<html><body><h1>Thanks for your order, #{customer.name}!</h1></body></html>"
end

Testar a integração

Para confirmar que seu redirecionamento está funcionando como esperado:

  1. Clique no botão de checkout.
  2. Preencha o nome do cliente e outros dados de pagamento.
  3. Clique em Pagar.

Se funcionar, você será redirecionado para a página de sucesso com a mensagem personalizada. Por exemplo, se você usou a mensagem dos exemplos de código, a página de sucesso exibirá: Obrigado pelo seu pedido, Jenny Rosen!

Esta página foi útil?
SimNão