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 geralExplore todos os produtos
Comece a criar
Comece a desenvolver
    Configure seu ambiente de desenvolvimento
    Envie sua primeira solicitação de API
    Aceitar um pagamento
    Criar e testar novos recursos
    Lista de verificação da transição para produção
Projetos de exemplo
Sobre as APIs
Build with an LLM
Use a Stripe sem programação
Configurar a Stripe
Crie uma conta
Dashboard da web
Dashboard móvel
Migrar para a Stripe
Gerenciar risco de fraudes
Entenda as fraudes
Proteção contra fraudes do Radar
Gerenciar contestações
Verificar identidades
Página inicialComece jáStart developing

Aceitar um pagamento

Aceitar pagamentos online com segurança

Crie um formulário de pagamento ou use uma página de checkout pré-integrada para começar a aceitar pagamentos online.

Redirecione para uma página de pagamento hospedada pela Stripe usando o Stripe Checkout. Compare esta integração com as outras formas de integração da Stripe.

Visualização do Checkout

Esforço de integração

Low-code

Tipo de integração

Redirecionar para a página de pagamento hospedada pela Stripe

Personalização da IU

Personalização limitada

Experimente

First, register for a Stripe account.

Use our official libraries to access the Stripe API from your application:

Command Line
Ruby
# Available as a gem sudo gem install stripe
Gemfile
Ruby
# If you use bundler, you can add this line to your Gemfile gem 'stripe'

Redirecione seu cliente para o Stripe Checkout
Lado do cliente
Lado do servidor

Adicione um botão de checkout ao site para chamar um endpoint do lado do servidor e criar uma sessão do Checkout.

Também é possível criar uma sessão do Checkout para um cliente existente, permitindo preencher campos do Checkout com dados de contato conhecidos e unificar o histórico de compras desse cliente.

checkout.html
<html> <head> <title>Buy cool new product</title> </head> <body> <!-- Use action="/create-checkout-session.php" if your server is PHP based. --> <form action="/create-checkout-session" method="POST"> <button type="submit">Checkout</button> </form> </body> </html>

A Sessão de Checkout a representação programática do que seu cliente vê ao ser redirecionado a um formulário de pagamento. Você pode configurá-lo com opções como:

  • Itens de linha a ser cobrado
  • Moedas a usar

Você deve preencher o success_url com o valor do URL de uma página no seu site para a qual o Checkout envia o cliente após a conclusão do pagamento. Como opção, você pode informar um valor cancel_url de uma página no seu site para a qual o Checkout envia o cliente se ele encerrar o processo de pagamento antes da conclusão.

Observação

As Sessões do Checkout expiram 24 horas após a criação por padrão.

Depois de criar uma Sessão do Checkout, redirecione o cliente ao URL retornado na resposta.

Ruby
# This example sets up an endpoint using the Sinatra framework. require 'json' require 'sinatra' require 'stripe' # 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'
post '/create-checkout-session' do session = Stripe::Checkout::Session.create({ line_items: [{ price_data: { currency: 'usd', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], mode: 'payment', # These placeholder URLs will be replaced in a following step. success_url: 'https://example.com/success', cancel_url: 'https://example.com/cancel', }) redirect session.url, 303 end

formas de pagamento

Por padrão, a Stripe habilita cartões e outras formas de pagamento comuns. É possível ativar ou desativar formas de pagamento individuais no Stripe Dashboard. No Checkout, a Stripe avalia a moeda e as restrições e apresenta dinamicamente as formas de pagamento aceitas ao cliente.

Para ver como as formas de pagamento aparecem para os clientes, informe um ID de transação ou defina um valor e moeda de pedido no Dashboard.

Você pode ativar Apple Pay e Google Pay nas configurações de formas de pagamento. Por padrão, o Apple Pay fica ativado, e o Google Pay, desativado. No entanto, em alguns casos, a Stripe remove-os mesmo quando estão ativados. Removemos o Google Pay se você ativar o imposto automático sem coletar um endereço de entrega.

As páginas hospedadas na Stripe do Checkout não precisam de mudanças na integração para habilitar Apple Pay ou Google Pay. A Stripe trata esses pagamentos da mesma forma que os outros pagamentos com cartão.

Confirme seu endpoint

Confirme se o endpoint pode ser acessado iniciando seu servidor web (por exemplo, localhost:4242) e executando o seguinte comando:

Command Line
curl -X POST -is "http://localhost:4242/create-checkout-session" -d ""

Você deve ver uma resposta no seu terminal assim:

Command Line
HTTP/1.1 303 See Other Location: https://checkout.stripe.com/c/pay/cs_test_... ...

Testes

Agora o botão de checkout já deve estar pronto para redirecionar seu cliente para o Stripe Checkout.

  1. Clique no botão de checkout.
  2. Você será redirecionado para o formulário de pagamento do Stripe Checkout.

Se a sua integração não estiver funcionando:

  1. Abra a guia Rede nas ferramentas de desenvolvedor do navegador.
  2. Clique no botão de checkout e confirme se uma solicitação de XHR foi enviada para o endpoint no lado do servidor (POST /create-checkout-session).
  3. Verifique se a solicitação retorna um status 200.
  4. Use console.log(session) dentro de seu ouvinte de clique do botão para confirmar se os dados corretos são retornados.

Mostrar uma página de finalização
Lado do cliente
Lado do servidor

É importante que o cliente veja uma página de finalização depois de enviar o formulário de pagamento corretamente. Hospede essa página de finalização no seu site.

Criar uma página de finalização mínima:

success.html
<html> <head><title>Thanks for your order!</title></head> <body> <h1>Thanks for your order!</h1> <p> We appreciate your business! If you have any questions, please email <a href="mailto:orders@example.com">orders@example.com</a>. </p> </body> </html>

Em seguida, atualize o endpoint de criação da sessão do Checkout para usar essa nova página:

Command Line
cURL
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 \ --data-urlencode success_url="http://localhost:4242/success.html" \ --data-urlencode cancel_url="http://localhost:4242/cancel.html"

Observação

Se quiser personalizar a página de finalização, leia o guia sobre a página de finalização personalizada.

Testes

  1. Clique no botão do checkout.
  2. Preencha os dados de pagamento com os dados do cartão de teste:
    • Informe o número do cartão 4242 4242 4242 4242.
    • Informe uma data futura qualquer como validade do cartão.
    • Informe qualquer número de 3 dígitos como CVC.
    • Informe qualquer código postal de cobrança.
  3. Clique em Pagar.
  4. Você será redirecionado para a nova página de finalização.

Em seguida, encontre o novo pagamento no Stripe Dashboard. Os pagamentos bem-sucedidos aparecem na lista de pagamentos. Quando você clicar em um pagamento, ele leva você até a página de detalhes do pagamento. A seção Resumo do checkout contém os dados de cobrança e a lista de itens comprados, que você pode usar para processar manualmente o pedido.

Processar eventos pós-pagamento

A Stripe envia um evento checkout.session.completed quando um cliente conclui o pagamento de uma sessão do Checkout. Use a ferramenta Dashboard webhook ou siga o guia de webhooks para receber e processar esses eventos, que podem levar você a:

  • Envie um e-mail de confirmação do pedido ao cliente.
  • Registre a venda em banco de dados.
  • Inicie um fluxo de trabalho de envio.

Escute esses eventos em vez de esperar que o cliente seja redirecionado de volta ao seu site. Acionar a execução apenas na página inicial do Checkout não é confiável. Configurar sua integração para escutar eventos assíncronos permite aceitar diferentes tipos de formas de pagamento com uma única integração.

Saiba mais no nosso guia de execução para o Checkout.

Gerencie os seguintes eventos ao coletar pagamentos com o Checkout:

EventoDescriçãoAção
checkout.session.completedEnviado quando um cliente conclui uma sessão do Checkout.Envie ao cliente uma confirmação de pedido e execute o pedido.
checkout.session.async_payment_succeededEnviado quando um pagamento feito com uma forma de pagamento postergada, como débito automático ACH, é bem-sucedido.Envie ao cliente uma confirmação de pedido e execute o pedido.
checkout.session.async_payment_failedEnviado quando ocorre uma falha em um pagamento feito com uma forma de pagamento postergada, como débito automático ACH.Notifique o cliente sobre a falha e traga-o de volta à sessão para tentar pagar novamente.

Teste sua integração

Para testar a integração do formulário de pagamento hospedado pela Stripe:

  1. Crie uma Sessão do Checkout.
  2. Preencha os dados de pagamento com um método da tabela a seguir.
    • Informe uma data futura qualquer como validade do cartão.
    • Informe qualquer número de 3 dígitos como CVC.
    • Informe qualquer código postal de cobrança.
  3. Clique em Pagar. Você será redirecionado para success_url.
  4. Acesse o Dashboard e procure o pagamento na página Transações. Se o seu pagamento for bem-sucedido, ele aparecerá na lista.
  5. Clique no pagamento para ver mais detalhes, como um resumo do Checkout com dados de faturamento e a lista de itens comprados. Você pode usar esses dados para executar o pedido.

Saiba como testar sua integração.

Número do cartãoCenárioComo testar
O pagamento com cartão é bem-sucedido e não precisa de autenticação.Preencha o formulário do cartão de crédito usando o número do cartão de crédito com qualquer validade, CVC e código postal.
O pagamento com cartão precisa de autenticação.Preencha o formulário do cartão de crédito usando o número do cartão de crédito com qualquer validade, CVC e código postal.
O cartão é recusado com um código de recusa como insufficient_funds.Preencha o formulário do cartão de crédito usando o número do cartão de crédito com qualquer validade, CVC e código postal.
O cartão UnionPay tem um comprimento variável de 13 a 19 dígitos.Preencha o formulário do cartão de crédito usando o número do cartão de crédito com qualquer validade, CVC e código postal.

Consulte Testes para obter mais informações sobre como testar sua integração.

Cartões de teste

NúmeroDescrição
Finaliza e processa o pagamento imediatamente.
Exige autenticação 3D Secure 2 para um pagamento bem-sucedido.
Sempre falha, com o código de recusa insufficient_funds.

OpcionalCriar produtos e preços

OpcionalPreencher dados do cliente
Lado do servidor

OpcionalSalvar dados da forma de pagamento
Lado do servidor

OpcionalSeparar autorização e captura
Lado do servidor

OpcionalGerenciamento de contas de clientes
Sem código

Veja também

  • Adicionar descontos
  • Recolher impostos
  • Coletar IDs fiscais
  • Adicionar envio
  • Personalize sua marca
  • Personalize sua página de finalização
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
Code quickstart
Guias relacionados
API Elements Appearance
Mais cenários de pagamento
Como funcionam os cartões
Produtos usados
Payments
Elements
Checkout