Update existing subscription

Updates the settings of an existing subscription.

By default, changes are applied to the upcoming payments of the recurrence. Payments that have already been generated remain unchanged. To also apply supported changes to pending payments, send updatePendingPayments: true.

nextDueDate defines the due date of the next payment yet to be generated and does not change the due date of existing payments.

⚠️

Suspension and reactivation

When you change status to INACTIVE, the subscription stops generating new payments, but existing payments remain unchanged.

To reactivate the subscription with status: ACTIVE, also provide a new nextDueDate.

📘

Credit card subscriptions

To change the value or due date of a credit card subscription, tokenization must be enabled.

To replace only the card used in the recurrence, use Update subscription credit card.

Changes to the recurrence can be tracked through the subscription Webhooks. To track the generated payments and their settlement, use the payment Webhooks.

Related content

Guides

Path Params
string
required

Unique subscription identifier in Asaas

Body Params
string
enum

Billing type

Allowed:
string
enum

Subscription status

Allowed:
date

First payment due

discount
object

Discount information

interest
object

Interest information for payment after due date

fine
object

Fine information for payment after due date

string
enum

Billing frequency

Allowed:
string

Subscription description (max. 500 characters)

date

Deadline for payments to be due

boolean

true to update the possible properties of already existing pending payments

string

Subscription identifier on your system

split
array of objects

Split information

split
callback
object

Automatic redirection information after the payment of the link payment

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