The Asaas Plugin allows your WooCommerce store to perform recurring charges using: WooCommerce Subscriptions.

In this model, WooCommerce is responsible for managing the subscription and Asaas performs the generation and processing of charges according to the configured periodicity.

When to use

Use subscriptions when your store sells recurring products or services, such as:

• monthly fees;
• subscription clubs;
• service plans;
• periodic charges.

If your operation is composed only of one-time sales, use the traditional charge methods available in the Asaas Plugin.

Prerequisites

Before using subscriptions, confirm that your store meets the following requirements:

• Asaas Plugin installed and configured;
• WooCommerce installed;
• WooCommerce Subscriptions installed and active;
• valid API Key configured;
• Webhooks working normally.

Compatible payment methods

Subscriptions support the following payment methods:

How it works

After purchase confirmation:

1. WooCommerce creates the subscription;
2. the Asaas Plugin sends the information to Asaas;
3. the subscription is registered;
4. a charge is generated according to the defined periodicity;
5. at each renewal, a new charge will be created automatically.

Payments will continue to be generated until the subscription is canceled or reaches its end date, when configured.

Charge renewal

Renewal occurs automatically according to the periodicity defined in the subscription.

Each new charge will follow the settings established at the time of creation, including:

• payment method;
• amount;
• interest;
• discounts;
• fines.

Subscription cancellation

When a subscription is canceled in WooCommerce:

• new charges stop being generated;
• existing charges remain following their own payment rules;
• charges already paid are not changed.

Limitations

Before using subscriptions, consider the following limitations:

• it is mandatory to use WooCommerce Subscriptions;
• Pix is not available as a direct payment method;
• One-Click Purchase depends on tokenization release by Asaas;
• some older versions of WooCommerce Subscriptions are not compatible with HPOS.

Known issues

If the subscription is not created after the purchase:

• confirm that WooCommerce Subscriptions is installed;
• check whether the Webhook queue is active;
• check the Asaas Plugin Logs;
• if using HPOS, enable compatibility mode when necessary.

For more details, see the Common errors page.

Best practices

Related content