WooCommerce Subscriptions

Use WooCommerce Subscriptions with the Asaas Plugin to receive recurring charges by bank slip or credit card.

WooCommerce manages the subscription lifecycle, while Asaas generates and processes the charges according to the configured frequency.

When to use

Use subscriptions for products or services with periodic charges, such as:

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

For one-time sales or installments, see Billing types.

Before you start

Confirm that your store has:

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

Supported payment methods

To review the bank slip and credit card settings, see Payment methods.

How it works

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Customer completes the purchase"] --> B["WooCommerce creates the subscription"]
B --> C["Plugin sends the data to Asaas"]
C --> D["Register the subscription"]
D --> E["Generate the cycle charge"]
E --> F["Process the payment"]
F --> G["Update the order via Webhook"]

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

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

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

At each renewal, a new charge is created automatically according to the subscription frequency.

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

Charge renewal

Each new charge follows the settings established for the subscription, including:

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

Use the plugin's Webhooks to track charge and order updates, without periodic queries.

See the WooCommerce Webhooks.

Cancellation

When you cancel a subscription in WooCommerce:

• new charges are no longer generated;
• existing charges continue to follow their own payment rules;
• charges already paid are not changed.

Validate the subscription

Before operating in Production, create a subscription in the Sandbox and confirm that:

• the subscription is created in WooCommerce;
• the subscription is registered in Asaas;
• the initial charge is generated;
• the order is updated after payment;
• a new charge is created on renewal.

Expected result

The subscription should remain active during the configured period and automatically generate new charges at each cycle.

Payment changes should be reflected in WooCommerce through Webhooks.

If only the order is created

If WooCommerce creates the order but the subscription is not processed correctly, go to:

WooCommerce > Settings > Advanced > Features

Then:

• enable WordPress posts storage (legacy); or
• enable compatibility mode, synchronize the subscriptions, and run a new test.

If the problem persists, see Common errors.

Limitations

Keep in mind that:

• WooCommerce Subscriptions is required;
• Pix is not available as a direct payment method;
• One-Click Purchase depends on tokenization being enabled by Asaas;
• in scenarios of incompatibility with the storage used by WooCommerce, it may be necessary to use legacy storage or compatibility mode.

Next steps

• Configure the payment methods
• Understand the billing types
• See the WooCommerce Webhooks
• See the common errors
• See the WooCommerce FAQ