Pular para o conteúdo
Criar conta
 ou
Entrar
O logotipo da documentação da Stripe
/
Criar conta
Login
Visão geral
Billing
Visão geralSobre as APIs do Billing
Assinaturas
Tributos
Visão geral
Relatórios
Visão geralRelatórios para várias contas
Dados
Visão geralEsquema

Configure uma assinatura com o débito automático SEPA

Saiba como criar e cobrar uma assinatura com o débito automático SEPA.

Uma sessão do Checkout representa os detalhes da intenção do cliente de fazer a compra. Você cria uma sessão do Checkout quando seu cliente quer iniciar uma assinatura. Após redirecionar seu cliente para uma sessão do Checkout, a Stripe apresenta um formulário de pagamento onde seu cliente pode concluir a compra. Assim que o cliente tiver finalizado uma compra, ele é redirecionado de volta para o seu site.

Configurar a Stripe
Lado do servidor

Instale o cliente Stripe de sua escolha:

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

Instale a Stripe CLI (opcional). A CLI fornece testes de webhook e você pode executá-la para criar produtos e preços.

Command Line
# Install Homebrew to run this command: https://brew.sh/
brew install stripe/stripe-cli/stripe

# Connect the CLI to your dashboard
stripe login

Para obter opções de instalação adicionais, consulte Comece a usar o Stripe CLI.

Criar o modelo de preços
Dashboard
Stripe CLI

Crie seus produtos e preços usando o Dashboard ou a Stripe CLI.

Este exemplo usa um serviço de preço fixo com duas opções diferentes de nível de serviço: Básico e Premium. Para cada opção de nível de serviço, você precisa criar um produto e um preço recorrente. (Se quiser adicionar uma cobrança avulsa para um item como tarifa de configuração, crie um terceiro produto com um preço avulso. Para simplificar, este exemplo não inclui uma cobrança avulsa.)

Neste exemplo, o faturamento de cada produto é mensal. O produto básico custa 5 EUR e o produto Premium custa 15 EUR.

Acesse a página Adicionar um produto e crie dois produtos. Adicione um preço para cada produto, cada um com um período de faturamento mensal recorrente:

  • Produto premium: serviço premium com recursos extras

    • Price: Flat rate | 15 EUR

  • Produto básico: serviço básico com recursos mínimos

    • Price: Flat rate | 5 EUR

Depois de criar os preços, registre o ID deles para utilizá-los em outras etapas. Os IDs de preço têm esta estrutura: price_G0FvDp6vZvdwRZ.

Quando tudo estiver pronto, use o botão Copiar para modo de produção, no canto superior direito, para clonar seu produto de uma área restrita para o modo de produção.

Para outros modelos de preços, consulte os exemplos de faturamento.

Criar uma sessão do Checkout
Do lado do cliente
Lado do servidor

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

index.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Crie uma sessão do Checkout com o ID de um Preço existente. Certifique-se de que o modo esteja definido como subscription e você passe pelo menos um preço recorrente. Você pode adicionar preços avulsos além de preços recorrentes. Depois de criar a sessão do Checkout, redirecione o cliente para o URL retornado na resposta.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "payment_method_types[]"="sepa_debit" \
  -d "line_items[][price]"=
{{PRICE_ID}}
 \
  -d "line_items[][quantity]"=1 \
  -d "mode"="subscription" \
  -d "success_url"="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d "cancel_url"="https://example.com/cancel" \

Quando o cliente finaliza um pagamento, é redirecionado para o success_url, uma página no seu site que informa ao cliente que o pagamento foi bem-sucedido. Disponibilize o ID da sessão na página de sucesso incluindo a variável de modelo {CHECKOUT_SESSION_ID} no success_url como no exemplo acima.

Quando o cliente clica no seu logotipo em uma sessão do Checkout sem concluir o pagamento, o Checkout redireciona o cliente de volta ao site, navegando para o cancel_url. Normalmente, essa é a página no seu site que o cliente visualizou antes de ser redirecionado para o Checkout.

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

No Dashboard, ative as formas de pagamento que deseja aceitar de seus clientes. O checkout aceita várias formas de pagamento.

Cuidado

Não dependa apenas do redirecionamento ao success_url para detectar a iniciação de um pagamento, pois:

  • Usuários mal-intencionados podem acessar diretamente o success_url sem pagar e acessar seus produtos ou serviços.
  • Os clientes podem não acessar o success_url após o pagamento. Eles podem fechar a guia do navegador antes do redirecionamento.

Confirmar a finalização do pagamento

Quando o cliente conclui um pagamento, a Stripe o redireciona para o URL que você especificou no parâmetro success_url. Normalmente, é uma página no site que informa seu cliente de que o pagamento foi bem-sucedido.

No entanto, SEPA Direct Debit é uma forma de pagamento com notificação posterior, o que significa que os fundos não ficam imediatamente disponíveis. Por isso, adie a execução do pedido até que os fundos estejam disponíveis. Após o êxito do pagamento, o status subjacente do PaymentIntent muda de processing para succeeded.

Você pode confirmar a realização do pagamento de várias maneiras:

Os pagamentos bem-sucedidos aparecem na lista de pagamentos do Dashboard. Quando você clica em um pagamento, a página de detalhes do pagamento é exibida. A seção Resumo do checkout contém dados de cobrança e a lista de itens comprados, que você pode usar para fazer a execução manual do pedido.

Observação

A Stripe ajuda você a acompanhar a entrada de pagamentos com o envio de notificações por e-mail sempre que um cliente efetua um. Use o Dashboard para configurar notificações por e-mail.

Testar a integração

Você pode testar a integração usando os IBANs abaixo. Os dados da forma de pagamento são coletados para todos os IBANs, mas cada um deles terá um comportamento diferente na cobrança.

IBANs de teste
Número da contaDescrição
DE89370400440532013000O status do PaymentIntent muda de processing para succeeded.
DE08370400440532013003O status do PaymentIntent muda de processing para succeeded após pelo menos três minutos.
DE62370400440532013001O status do PaymentIntent muda de processing para requires_payment_method.
DE78370400440532013004O status do PaymentIntent muda de processing para requires_payment_method após pelo menos três minutos.
DE35370400440532013002O status do PaymentIntent muda de processing para succeeded, mas uma contestação é imediatamente criada.
DE65370400440000343434O pagamento falha com um código de falha charge_exceeds_source_limit devido ao valor do pagamento fazer com que a conta exceda o limite de volume de pagamentos semanal.
DE27370400440000121212O pagamento falha com um código de falha charge_exceeds_weekly_limit quando o valor do pagamento excedeu o limite de volume de transações da conta.
DE65370400440002222227O pagamento falha com um código de falha insufficient_funds.

Veja também

Esta página foi útil?
SimNão