Definir formas de pagamento por assinatura
O parâmetro de assinatura payment_settings
permite definir formas de pagamento específicas em assinaturas individuais, proporcionando maior flexibilidade que uma única default_payment_method
ou configurações de cliente menos detalhadas.
Antes de habilitar formas de pagamento, você precisa ativá-las nas configurações da conta.
Em algumas situações, pode haver restrições que impedem a utilização de uma forma de pagamento em uma assinatura. Por exemplo, uma forma pagamento pode operar apenas em uma moeda ou ter limites para o valor pago. A Stripe não seleciona automaticamente formas de pagamento que não podem ser usadas devido a essas restrições.
Selecionar manualmente formas de pagamento
Altere as configurações de pagamento das formas de pagamento para substituir as que podem ser usadas para pagar uma assinatura.
Quando você configurar uma forma de pagamento padrão no objeto Customer ou Subscription, não deixe de inclui-la na lista payment_method_types
. Caso contrário, a forma de pagamento não será usada e o pagamento poderá falhar.
Prioridade de formas de pagamento
Por padrão, os clientes podem pagar uma fatura de assinatura com qualquer forma de pagamento habilitada nas configurações do modelo de fatura. Essas configurações prevalecem sobre a antiga configuração de cliente default_source
.
Se definido, o parâmetro payment_settings.payment_method_types
de uma assinatura prevalece sobre as configurações padrão da fatura, mas apenas nessa assinatura específica. Os tipos de forma de pagamento são passados no Setup Intent e nas faturas da assinatura.
Você também pode especificar default_payment_method
(ou o antigo default_source
) da assinatura para priorizar alguma forma de pagamento.
Erros de forma de pagamento
Os erros de forma de pagamento podem impedir a criação de uma assinatura. Isso pode acontecer quando:
- Você seleciona manualmente uma forma de pagamento, mas uma restrição (como as moedas aceitas) impede que ela seja usada.
- Uma forma de pagamento não está ativada na sua conta
No momento do pagamento, podem ocorrer erros que impedem a Stripe de finalizar a fatura. Consulte os erros de forma de pagamento para saber mais.
Opções de formas de pagamento
Algumas formas de pagamento têm opções adicionais que permitem personalizar a experiência de pagamento. Consulte a documentação sobre opções de formas de pagamento para obter detalhes.