Salvar dados de pagamento durante o pagamento

Saiba como aceitar um pagamento e salvar os dados de pagamento do seu cliente para compras futuras.

Observação

O suporte a formas de pagamento salvas usando Elements e a API Checkout Sessions inclui apenas cartões. Ele não aceita outras formas de pagamento salvas, como contas bancárias.

Ativar formas de pagamento salvas

Cuidado

As leis globais de privacidade são complicadas e cheia de nuances. Antes de implementar a capacidade de armazenar dados de forma de pagamento do cliente, trabalhe com sua equipe jurídica para assegurar que ela esteja em conformidade com sua estrutura de privacidade e conformidade.

Para permitir que um cliente salve a forma de pagamento para uso futuro, especifique o parâmetro saved_payment_method_options.payment_method_save quando criar a sessão do Checkout.

Para salvar uma forma de pagamento, é preciso ter um Customer. Passe um cliente existente ou, para criar um cliente, defina a sessão do Checkout customer_creation como always.

Depois de criar a sessão do Checkout, use o segredo do cliente retornado na resposta para criar sua página de checkout.

Adicione elementsOptions extras em initCheckout para que o Elemento de Pagamento exiba uma caixa de seleção solicitando o consentimento de cobrança.

checkout.js
const checkout = await stripe.initCheckout({
  fetchClientSecret,
  elementsOptions: {
    savedPaymentMethod: {
      enableSave: 'auto',
    }
  }
});

Reutilizar uma forma de pagamento salva anteriormente

Cada forma de pagamento salva é vinculada a um objeto Customer. Antes de criar a sessão do Checkout, autentique o cliente e passe o ID do cliente correspondente à sessão do Checkout.

O Elemento de pagamento exibe automaticamente os métodos de pagamento salvos previamente, para que o cliente possa utilizá-los no Checkout.

Você também pode permitir que o Elemento de Pagamento mostre novamente os métodos salvos para o cliente durante o checkout, inserindo elementsOptions adicionais na função initCheckout.

checkout.js
const checkout = await stripe.initCheckout({
  fetchClientSecret,
  elementsOptions: {
    savedPaymentMethod: {
      enableSave: 'auto',
      enableRedisplay: 'auto',
    }
  }
});