Create new subscription

Creates a new subscription to generate recurring payments according to the configured billing cycle.

Future payments are generated gradually over the course of the recurrence; they are not all created when the subscription is created. Each payment has its own ID, status, and financial cycle.

The response represents the created subscription and includes its ID, which is used in subsequent operations related to the recurrence.

📘

Tracking the recurrence

Creating the subscription does not confirm any payment.

Use the subscription Webhooks to track the subscription lifecycle and the payment Webhooks to track the generated payments and their settlement.

To provide the card data directly at creation, use Create subscription with credit card.

Related content

Guides

Body Params
string
required

Unique customer identifier in Asaas

string
enum
required

Billing type

Allowed:
number
required

Subscription value

date
required

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
required

Billing frequency

Allowed:
string

Subscription description (max. 500 characters)

date

Deadline for payments to be due

int32

Maximum number of payments to be generated for this subscription

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

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