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_
, 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.
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.
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
Esta etapa só é necessária se você planeja usar alguma destas formas de pagamento: débito automático Bacs, transferências bancárias, boleto, débitos pré-autorizados no Canadá, Konbini, OXXO, Pay by Bank, débito automático SEPA, SOFORT ou 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 a realização de um novo pedido. |
Todos esses eventos incluem o objeto Checkout Session.
Atualize seu gerenciador de eventos para executar o pedido:
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.
, 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
Consulte Testes para obter mais informações sobre como testar sua integração.