A API Setup Intents

Use a API Setup Intents para configurar uma forma de pagamento para pagamentos futuros. O funcionamento é similar ao de um pagamento, mas não se cria uma cobrança. Configure já uma forma de pagamento para pagamentos futuros.

O objetivo é salvar e preparar as credenciais de pagamento para pagamentos futuros, configurando a forma de pagamento corretamente para qualquer situação. Ao configurar um cartão, por exemplo, pode ser preciso autenticar o cliente ou verificar a validade do cartão no banco do cliente. A Stripe atualiza o objeto SetupIntent durante esse processo.

Salvar e reutilizar formas de pagamento

A API Setup Intents é útil para empresas que aceitam clientes mas não cobram imediatamente:

• Uma empresa de aluguel de veículos que coleta dados de forma de pagamento antes de o cliente alugar o carro e cobra o cartão após o término do período de aluguel
• Um site de crowdfunding que coleta detalhes do cartão para ser cobrado posteriormente, somente se a campanha atingir um determinado valor
• Uma empresa de serviços públicos que cobra um valor diferente a cada mês, com base no uso, mas coleta detalhes de pagamento SEPA antes do pagamento do primeiro mês

Comece já

• Salvar cartões sem fazer um pagamento inicial
• Salvar dados bancários para pagamentos com débito automático SEPA
• Salvar dados bancários para pagamentos com débito automático BECS

Obtenha permissão para salvar uma forma de pagamento

Você é responsável pela conformidade com todas as leis, regulamentos e regras de rede aplicáveis ao salvar os dados de pagamento de um cliente.

Uso futuro na sessão

Se você configurar uma forma de pagamento para pagamentos futuros na sessão, como exibir a forma de pagamento em uma página de checkout futura, você deve obter explicitamente o consentimento do cliente para esse uso específico. Por exemplo, inclua uma caixa de seleção “Salvar minha forma de pagamento para uso futuro” para obter o consentimento.

Se você precisar diferenciar entre formas de pagamento salvas apenas para uso offline e formas de pagamento que você pode apresentar ao seu cliente para futuras compras na sessão, você pode utilizar o parâmetro allow_redisplay no objeto PaymentMethod.

Uso futuro fora da sessão

Para configurar uma forma de pagamento para pagamentos futuros fora de sessão, você precisa de permissão. Criar um contrato inicial (também chamado de mandato) permite que você cobre o cliente quando ele não estiver conectado e usando seu site ou aplicativo.

Publique os termos, que devem ser confirmados e aceitos pelo cliente, explicando como os pagamentos são processados no site ou aplicativo. Os termos devem incluir pelo menos os dados a seguir:

• Permissão do cliente para iniciar um pagamento ou uma série de pagamentos em seu nome
• A frequência prevista dos pagamentos (ou seja, pagamento avulso ou recorrente)
• Como será definido o valor dos pagamentos

Veja recomendações para o texto do mandato para salvar cartões ou salvar dados bancários SEPA.

Para usuários que precisam seguir a SCA, este contrato ajuda a autorizar os pagamentos sem interrupções. Se sua integração estiver corretamente configurada para salvar um cartão, a Stripe marcará os futuros pagamentos fora de sessão como transações iniciadas pelo comerciante (MIT) para que os clientes não precisem se conectar outra vez para fazer a autenticação. Para fazer transações iniciadas pelo comerciante, você precisa de um contrato com o cliente.

Especifique o uso para aumentar a taxa de sucesso

O parâmetro usage indica à Stripe como você pretende usar a forma de pagamento no futuro. Para algumas formas de pagamento, a Stripe pode usar sua configuração de usage para selecionar o fluxo mais simples para o cliente. Essa otimização deve aumentar o número de pagamentos bem-sucedidos.

Por exemplo, cartões de crédito e débito sujeitos à regulamentação europeia SCA podem exigir que o cliente autentique o cartão durante o processo de salvamento. Definir o parâmetro usage como off_session autentica corretamente o cartão de crédito ou débito para pagamentos fora de sessão para que o cliente não precise se conectar novamente e repetir a autenticação. Embora haja uma complicação inicial no fluxo de configuração, definir usage como off_session pode reduzir a intervenção do cliente em futuros pagamentos fora de sessão.

No entanto, se você só quiser usar o cartão quando o cliente estiver no checkout, defina usage como on_session. O banco saberá que você planeja usar o cartão quando o cliente estiver disponível para fazer a autenticação, o que permite postergar a autenticação dos dados do cartão e evitar o atrito inicial.

Usage é uma otimização. Você ainda pode usar um cartão configurado para pagamentos na sessão para fazer pagamentos fora da sessão, mas é provável que os bancos recusem o pagamento e exijam a autenticação do cliente. Os dois casos podem exigir autenticação posterior, por isso, crie um processo de recuperação no aplicativo. Quando um pagamento com cartão fora de sessão exigir autenticação, deixe o cliente online de volta para concluir o pagamento.

Por padrão, o parâmetro usage é definido como off_session. Veja como criar um SetupIntent no seu servidor e especifique o usage:

curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d usage=on_session