Get to know Subscriptions

Subscriptions automate the generation of recurring payments for the same customer.

After you create the subscription, Asaas generates new payments according to the configured frequency. Each payment has its own ID, status, and financial cycle.

When to use

Use Subscriptions when your integration needs to:

• generate payments at recurring intervals;
• use bank slip (boleto), Pix, or credit card;
• automate monthly fees, plans, or recurring services;
• avoid manually creating a new payment each cycle.

How it works

The subscription works as a schedule for generating payments.

%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
    A["Register the customer"] --> B["Create the subscription"]
    B --> C["Asaas generates the payments"]
    C --> D["Process the payment"]
    D --> E["Receive the Webhooks"]
    E --> F["Update the application"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px,font-size:17px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px,font-size:17px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px,font-size:17px

    class A inicio
    class B,C,D,E validacao
    class F sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

Payments are generated gradually according to the recurrence. Creating the subscription does not generate all future payments at once.

By default, each new payment is created 40 days before the due date. This period can be configured to 14 or 7 days before the due date.

See how to create a subscription.

Choose the payment method

For credit card, the card details can be sent when creating the subscription for validation and use in future payments.

See Subscription with credit card.

Track the generated payments

Each payment belongs to the subscription, but has its own lifecycle.

Therefore, your integration must track new payments and status changes via Webhooks, especially when performing:

• financial reconciliation;
• payment synchronization;
• release of products or services;
• invoice issuance.

See the payment events.

Related features

After implementing the recurrence, other features can complement the flow:

Next steps

• Create a subscription
• Create a subscription with credit card
• Configure automatic invoice issuance
• Understand the blocking flow due to Split mismatch
• Compare Automatic Pix and Subscriptions
• See the Subscriptions FAQ