# Definir formas de pagamento por assinatura Saiba como especificar as formas de pagamento disponíveis para uma assinatura. O parâmetro subscription [payment_settings](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-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](https://dashboard.stripe.com/settings/payment_methods) 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](https://docs.stripe.com/payments/payment-methods/payment-method-support.md#product-support). ## Selecionar manualmente formas de pagamento Altere as [configurações de pagamento](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-payment_settings) das formas de pagamento para substituir as que um cliente pode usar para pagar uma assinatura. ```curl curl https://api.stripe.com/v1/subscriptions/sub_49ty4767H20z6a \ -u "<>:" \ -d "payment_settings[payment_method_types][]=card" \ -d "payment_settings[payment_method_types][]=customer_balance" ``` Se você configurou uma forma de pagamento padrão no cliente (representada como uma [Conta](https://docs.stripe.com/api/v2/core/accounts/update.md#v2_update_accounts-response-configuration-customer-billing-default_payment_method) configurada pelo cliente ou um [Cliente](https://docs.stripe.com/api/customers/object.md#customer_object-invoice_settings-default_payment_method)) ou na [Assinatura](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_payment_method), inclua-a na lista de `payment_method_types`. Caso contrário, esse método não será usado e o pagamento poderá falhar. ## Prioridade de formas de pagamento Por padrão, os clientes podem pagar a *fatura* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) gerada de uma assinatura com qualquer uma das formas de pagamento habilitadas na [configuração de forma de pagamento padrão da fatura](https://dashboard.stripe.com/settings/billing/invoice). Isso tem prioridade sobre a configuração antiga [default_source](https://docs.stripe.com/api/customers/object.md#customer_object-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](https://docs.stripe.com/api/setup_intents.md) 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](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-payment_settings-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](https://dashboard.stripe.com/subscriptions), 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](https://docs.stripe.com/invoicing/payment-methods.md#payment-method-errors) 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](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-payment_settings) para obter detalhes.