A API Setup Intents

Saiba mais sobre a API Setup Intents para salvar formas de pagamento.

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.

IU que coleta dados do cartão, mas não cobra o cartão

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

Observação

Você também pode configurar formas de pagamento para uso futuro no Checkout.

Comece já

Obter permissão para salvar uma forma de pagamento

Conformidade

Você é responsável por cumprir todas as leis, regulamentos e regras da bandeira em vigor ao salvar os dados de pagamento de um cliente. Se você configurar uma forma de pagamento para futuros pagamentos em sessão, como exibir a forma de pagamento em uma página de checkout futura, não se esqueça de coletar explicitamente o consentimento do cliente para esse uso específico. Por exemplo, inclua a caixa de seleção “Salvar minha forma de pagamento para uso futuro” para coletar o consentimento. Se precisar diferenciar entre formas de pagamento salvas somente para uso offline e formas de pagamento que você pode apresentar ao seu cliente para futuras compras em sessão, você pode utilizar o parâmetro allow_redisplay no objeto PaymentMethod.

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.

Aumentar a taxa de aprovação com a especificação do uso

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.

Como você pretende usar o cartão	Valor da enumeração de usage a ser aplicado
Somente para pagamentos na sessão	`on_session`
Somente para pagamentos fora da sessão	`off_session` (padrão)
Pagamentos na sessão ou fora da sessão	`off_session` (padrão)

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:

Observação

Siga as instruções desta página para que sua integração funcione com cartões que exigem Autenticação Forte de Cliente. Marcar corretamente as transações permite que a Stripe ignore a SCA quando for permitido, evitando que a autenticação seja necessária em todos os pagamentos.