Definir formas de pagamento por assinatura

O parâmetro subscription payment_settings permite definir formas de pagamento específicas em assinaturas individuais. Isso permite mais flexibilidade do que um único default_payment_method ou configurações de cliente menos detalhadas.

Para habilitar uma forma de pagamento, primeiro é preciso ativá-la nas configurações de conta no Stripe Dashboard.

Em algumas situações, pode haver restrições que impedem o uso de determinadas formas de pagamento em uma assinatura. Por exemplo, uma forma de pagamento pode operar apenas em uma moeda ou ter limites para o valor que o cliente pode pagar. A Stripe não seleciona automaticamente uma forma de pagamento se suas limitações impedirem que ela seja usada. Saiba mais sobre o suporte a formas de pagamento.

Selecionar manualmente formas de pagamento

Altere as configurações de pagamento das formas de pagamento para substituir as que um cliente pode usar para pagar uma assinatura.

curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_settings[payment_method_types][]"=card \
  -d "payment_settings[payment_method_types][]"=customer_balance

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 a fatura gerada de uma assinatura com qualquer uma das formas de pagamento habilitadas na configuração de forma de pagamento padrão da fatura. Isso tem prioridade sobre a configuração antiga default_source do cliente.

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.

Se você habilitar Salvar dados de pagamento do cliente nas configurações de faturas do Dashboard ou no parâmetro save_default_payment_method da Subscription, qualquer forma de pagamento usada pelo cliente para pagar a fatura se tornará o novo padrão.

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 você pode definir para personalizar a forma como o cliente paga. Consulte a documentação sobre opções de formas de pagamento para obter detalhes.