Migrar formas de pagamento para o Dashboard

Ative diferentes formas de pagamento do Checkout usando o Dashboard.

Ao alterar sua integração para obter suas preferências de forma de pagamento do Dashboard, a Stripe exibe todas as formas de pagamento compatíveis com seus clientes quando eles fizerem checkout, dependendo da moeda escolhida ou de restrições das formas de pagamento, como valores máximos de transação. A Stripe também apresenta as formas de pagamento mais relevantes para cada cliente com base na localização e moeda utilizada.

A página de checkout prioriza a exibição de formas de pagamento conhecidas por aumentar a conversão para a localização do seu cliente, enquanto formas de pagamento de prioridade menor ficam ocultas sob um menu de navegação. Seus clientes veem várias formas de pagamento no checkout que são populares para o local e a moeda. Contudo, eles ainda têm a opção de escolher uma forma de pagamento diferente no menu de navegação.

Atualizar sua integração

Para integrações existentes do Stripe Checkout que especificam payment_method_types, você deve remover esse parâmetro para migrar as preferências de formas de pagamento para o Dashboard. Depois que você remove o parâmetro da integração, algumas formas de pagamento são ativadas automaticamente, incluindo cartões e carteiras. O parâmetro currency restringe as formas de pagamento vistas pelo cliente na sessão do Checkout.

Aviso

Atualizar sua integração inicialmente desativa todas as formas de pagamento não padrão da sua integração, como redirecionamentos bancários. Se você adicionou formas de pagamento à integração do Checkout, vá até a página de configurações de formas de pagamento no Dashboard para ativá-las novamente.

Ver formas de pagamento disponíveis no Dashboard

Confira suas configurações de formas de pagamento para ver as formas de pagamento que você aceita atualmente. Essa lista inclui as formas de pagamento ativadas por padrão, como cartões. Elas custam o mesmo ou menos do que cartões e são liquidadas imediatamente.

Payment methods

By default, Stripe enables cards and other common payment methods. You can turn individual payment methods on or off in the Stripe Dashboard. In Checkout, Stripe evaluates the currency and any restrictions, then dynamically presents the supported payment methods to the customer.

To see how your payment methods appear to customers, enter a transaction ID or set an order amount and currency in the Dashboard.

You can enable Apple Pay and Google Pay in your payment methods settings. By default, Apple Pay is enabled and Google Pay is disabled. However, in some cases Stripe filters them out even when they’re enabled. We filter ApplePay if you set setup_future_usage (either top-level or in payment_method_options for card), and we filter Google Pay if you enable automatic tax without collecting a shipping address.

Checkout’s Stripe-hosted pages don’t need integration changes to enable Apple Pay or Google Pay. Stripe handles these payments the same way as other card payments.

Adicionar ou remover formas de pagamento da sua integração

Na página do Dashboard de configurações de forma de pagamento, você pode ver as formas de pagamento disponíveis e ativar novas formas de pagamento para a sua integração.

Você pode ativar algumas formas de pagamento apenas selecionando Ativar. No entanto, algumas formas de pagamento precisam de etapas adicionais para serem ativadas. Nesses casos, você verá um botão Configurar ou Revisar termos.

Para saber mais sobre quais formas de pagamento são adequadas para sua empresa, consulte o guia de formas de pagamento.

(Recomendado) Gerenciar formas de pagamento com notificação posterior

Dependendo do tipo de forma de pagamento que você integrar, pode haver um atraso de 2 a 14 dias na confirmação do pagamento. Se configurar webhooks para executar automaticamente os pedidos com sua integração do Checkout, quando você adicionar as primeiras formas de pagamento com notificação posterior, talvez seja necessário atualizar o código.

Cuidado

This step is only required if you plan to use any of the following payment methods: Bacs Direct Debit, Bank transfers, Boleto, Canadian pre-authorized debits, Konbini, OXXO, Pay by Bank, SEPA Direct Debit, SOFORT, or ACH Direct Debit.

Quando você recebe por formas de pagamento de notificação posterior, os fundos não são disponibilizados imediatamente. O processamento pode levar vários dias, então você deve aguardar para executar o pedido depois que os fundos chegarem à sua conta. Quando o pagamento for processando, o status correspondente do PaymentIntent passará de processing para succeeded.

Você precisa administrar os seguintes eventos do Checkout:

Nome do evento	Descrição	Próximas etapas
checkout.session.completed	O cliente autorizou o pagamento por débito enviando o formulário do Checkout.	Aguarde a confirmação ou falha do pagamento.
checkout.session.async_payment_succeeded	O pagamento do cliente foi confirmado.	Execute o pedido de mercadorias ou serviços.
checkout.session.async_payment_failed	O pagamento foi recusado ou houve outro erro.	Entre em contato com o cliente por e-mail e solicite que seja feito um novo pedido.

These events all include the Checkout Session object.

Atualize seu gerenciador de eventos para executar o pedido:

Ruby
# 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_4eC39HqLyjWDarjtT1zdp7dc'


# You can find your endpoint's secret in the output of the `stripe listen`
# command you ran earlier
endpoint_secret = 'whsec_...'

post '/webhook' do
  event = nil

  # Verify webhook signature and extract the event
  # See https://stripe.com/docs/webhooks#verify-events for more information.
  begin
    sig_header = request.env['HTTP_STRIPE_SIGNATURE']
    payload = request.body.read
    event = Stripe::Webhook.construct_event(payload, sig_header, endpoint_secret)
  rescue JSON::ParserError => e
    # Invalid payload
    return status 400
  rescue Stripe::SignatureVerificationError => e
    # Invalid signature
    return status 400
  end

  case event['type']
  if event['type'] == 'checkout.session.completed'
    checkout_session = event['data']['object']

    fulfill_order(checkout_session)
  end
  when 'checkout.session.completed'
    checkout_session = event['data']['object']

    # Save an order in your database, marked as 'awaiting payment'
    create_order(checkout_session)

    # Check if the order is already paid (for example, from a card payment)
    #
    # A delayed notification payment will have an `unpaid` status, as
    # you're still waiting for funds to be transferred from the customer's
    # account.
    if checkout_session.payment_status == 'paid'
      fulfill_order(checkout_session)
    end
  when 'checkout.session.async_payment_succeeded'
    checkout_session = event['data']['object']

    # Fulfill the purchase...
    fulfill_order(checkout_session)
  when 'checkout.session.async_payment_failed'
    session = event['data']['object']

    # Send an email to the customer asking them to retry their order
    email_customer_about_failed_payment(checkout_session)
  end

  status 200
end

def fulfill_order(checkout_session)
  # TODO: fill in with your own logic
  puts "Fulfilling order for #{checkout_session.inspect}"
end

def create_order(checkout_session)
  # TODO: fill in with your own logic
  puts "Creating order for #{checkout_session.inspect}"
end

def email_customer_about_failed_payment(checkout_session)
  # TODO: fill in with your own logic
  puts "Emailing customer about payment failure for: #{checkout_session.inspect}"
end

Testes

Verifique se stripe listen ainda está em execução. Passe pelo Checkout como usuário de teste, assim como na etapa anterior. Seu gerenciador de eventos deve receber o evento checkout.session.completed, e o gerenciamento deve acontecer corretamente.

Agora que essas etapas já foram executadas, você pode entrar em produção quando quiser.

Teste a integração

Número do cartão	Cenário	Como 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.