Update existing subscription


When updating a subscription, the nextDueDate parameter is used to indicate the due date of the next installment to be generated, meaning it does not update the due date of the already generated installment.

Additionally, when updating the subscription amount or payment method, only future installments will be affected. To update existing installments with the new payment method and/or amount, you need to pass the updatePendingPayments: true parameter.

📘

You can suspend the subscription by setting the status to INACTIVE. This will stop new billings from being generated until it is set to ACTIVE again. When resuming a subscription, it is mandatory to inform the nextDueDate of the next generated subscription.

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