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.

Permitir que os clientes atualizem a forma de pagamento

No Dashboard, você pode gerar links de uso único que permitem que os clientes atualizem a forma de pagamento em uma assinatura cobrada automaticamente.

Você pode gerar um link de atualização em dois lugares:

• Na página Detalhes da assinatura, clique no menu Ações e selecione Compartilhar link de atualização de pagamento.
• Na página Assinaturas, localize a assinatura, clique no menu de navegação () e selecione Compartilhar link de atualização de pagamento.

Na caixa de diálogo Compartilhar link de atualização de pagamento, você pode enviar o link por e-mail diretamente para o cliente ou copiá-lo para compartilhar de outra forma. Você também pode desativar todos os links de atualização de pagamento existentes da assinatura.

Somente é possível gerar links para assinaturas que têm o Billing definido como Auto. O item de menu não aparece para assinaturas com o Billing definido como Send.

Os links de atualização de pagamento de assinatura têm as seguintes restrições:

• Um link só pode atualizar a forma de pagamento na assinatura associada, não podendo alterar a forma de pagamento padrão do cliente.
• O status da assinatura precisa ser active, past_due ou trialing. Não pode ser unpaid ou encerrado.
• A nova forma de pagamento precisa ser um cartão.
• Cada link só permite que um cliente atualize seus dados de pagamento uma única vez.
• Os links não utilizados se tornam inválidos após 30 dias.

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.