O Stripe Checkout oferece o Link, uma opção de pagamento em um clique para que os clientes salvem e reutilizem com segurança os dados de pagamento. No entanto, se você precisa salvar uma forma de pagamento para cobrá-la fora da sessão ou prefere gerenciar as formas de pagamento salvas, será necessário salvar a forma de pagamento em um Customer. Allow_redisplay é um parâmetro do objeto PaymentMethod que ajuda a modelar se você recebeu consentimento do cliente para preencher automaticamente as informações do cartão salvo em compras futuras.

Como salvar formas de pagamento no Checkout: 

O modo usado no Checkout determina se e como uma forma de pagamento é salva. 

• Modo de pagamento: Por padrão, a Stripe não salva informações da forma de pagamento em pagamentos avulsos no modo de pagamento. Você pode usar payment_intent_data.setup_future_usage para salvar uma forma de pagamento no modo de pagamento de um Customer. Isso é útil quando você precisa capturar uma forma de pagamento registrada para cobrar tarifas futuras com o consentimento do cliente, como tarifas de cancelamento ou não comparecimento. Por padrão, essas formas de pagamento são salvas com allow_redisplay: limited e não são preenchidas automaticamente em compras futuras. Como alternativa, você pode deixar os clientes escolherem se desejam salvar as informações do cartão para compras futuras usando saved_payment_method_options.payment_method_save. Use esse parâmetro para exibir uma caixa de seleção adicional na página do Checkout que o cliente pode marcar para salvar os dados de pagamento. Quando a caixa de seleção é marcada, os cartões são salvos com allow_redisplay: always e serão preenchidos automaticamente quando os clientes retornarem.

• Modo de assinatura: As formas de pagamento são salvas no Customer quando o Checkout é usado no modo de assinatura para cobrar a forma de pagamento em pagamentos recorrentes. Essas formas de pagamento são salvas com allow_redisplay: limited e não são preenchidas automaticamente em compras futuras. Você pode usar saved_payment_method_options.payment_method_save para permitir que os clientes salvem a forma de pagamento para preenchimento em compras futuras.

• Modo de configuração: Esse modo foi projetado exclusivamente com o objetivo de obter o consentimento do cliente para salvar formas de pagamento para uso futuro.  As formas de pagamento salvas no modo de configuração são salvas por padrão com allow_redisplay: always e serão preenchidas na passagem de um objeto Customer para uma sessão do Checkout.

Substituição ou alteração do comportamento de allow_redisplay

Esse comportamento padrão facilita a conformidade com as regras das bandeiras de cartão e as regulamentações de proteção de dados. Se você tiver que alterar o comportamento padrão habilitado por esses modos, pode usar estes métodos: 

• Alterar o valor de allow_redisplay na forma de pagamento: Você pode usar a API PaymentMethod para alterar o valor de allow_redisplay definido na forma de pagamento. 
• Substituir o valor de allow_redisplay definido no Checkout: Você pode usar payment_method_data.allow_redisplay para substituir o valor de allow_redisplay definido nas formas de pagamento salvas no Checkout.

• Substituir as formas de pagamento salvas mostradas: Por padrão, o Checkout mostra apenas as formas de pagamento salvas com allow_redisplay: always. Você pode usar saved_payment_method_options.allow_redisplay_filters para determinar se as formas de pagamento com allow_redisplay: limited ou unspecified também são mostradas.

---

CUIDADO

As leis globais de privacidade são complicadas e variadas.  Recomendamos entrar em contato com a equipe jurídica ou de privacidade antes de implementar setup_future_usage  ou substituir os comportamentos padrão do Checkout para salvar e mostrar novamente dados de pagamento, porque isso pode afetar a estrutura de conformidade com requisitos de privacidade. Por exemplo, o Conselho Europeu de Proteção de Dados emitiu uma orientação a respeito de salvar dados de pagamento.  Saiba como configurar o Checkout para obter o consentimento e salvar formas de pagamento para uso futuro aqui.

---

Impacto nas integrações existentes

Se você criou uma conta Stripe antes de 18 de abril, as formas de pagamento salvas anteriormente pelo Checkout foram preenchidas retroativamente com o valor adequado de allow_redisplay. 
A partir de 1º de maio de 2024, o Checkout não exibe mais cartões salvos com allow_redisplay: limited ou unspecified quando os clientes retornam. Se tiver alguma dúvida sobre essa mudança, fale com o suporte.

---

Próximas melhorias nas formas de pagamento salvas no Checkout

• Mostrar várias formas de pagamento salvas: Hoje, o cliente só consegue ver o cartão salvo mais recente no Checkout. Em breve, permitiremos que clientes com vários cartões salvos vejam e escolham entre todos os cartões salvos qualificados. 

• Permitir que os clientes excluam formas de pagamento salvas no Checkout: Em breve, ofereceremos um novo recurso para você permitir que os clientes excluam formas de pagamento salvas no Checkout.