Atualizar assinatura existente

Atualiza as configurações de uma assinatura existente.

Por padrão, as alterações são aplicadas às próximas cobranças da recorrência. Cobranças já geradas permanecem inalteradas. Para aplicar alterações suportadas também às cobranças pendentes, informe updatePendingPayments: true.

nextDueDate define o vencimento da próxima cobrança que ainda será gerada e não altera o vencimento de cobranças existentes.

⚠️

Suspensão e reativação

Ao alterar status para INACTIVE, a assinatura deixa de gerar novas cobranças, mas as cobranças existentes permanecem inalteradas.

Para reativar a assinatura com status: ACTIVE, informe também um novo nextDueDate.

📘

Assinaturas com cartão de crédito

Para alterar o valor ou o vencimento de uma assinatura com cartão de crédito, a tokenização deve estar habilitada.

Para substituir apenas o cartão utilizado na recorrência, utilize Atualizar cartão de crédito da assinatura.

As alterações da recorrência podem ser acompanhadas pelos Webhooks de assinaturas. Para acompanhar as cobranças geradas e seus pagamentos, utilize os Webhooks de cobranças.

Conteúdos relacionados

Guides

Path Params
string
required

Identificador único da assinatura no Asaas

Body Params
string
enum

Forma de pagamento

Allowed:
string
enum

Status da assinatura

Allowed:
date

Vencimento da primeira cobrança

discount
object

Informações de desconto

interest
object

Informações de juros para pagamento após o vencimento

fine
object

Informações de multa para pagamento após o vencimento

string
enum

Periodicidade da cobrança

Allowed:
string

Descrição da assinatura (máx. 500 caracteres)

date

Data limite para vencimento das cobranças

boolean

true para atualizar as propriedades possíveis de cobranças pendentes já existentes

string

Identificador da assinatura no seu sistema

split
array of objects

Informações de split

split
callback
object

Informações de redirecionamento automático após pagamento do link de pagamento

Responses

404

Not found

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json