FAQ - WooCommerce

Use this FAQ for recurring questions about installation, authentication, payment methods, subscriptions, Webhooks, and checkout in the Asaas Plugin for WooCommerce.

To configure or diagnose a specific flow, use the guide indicated in each answer.

Which plugins are required to use the Asaas Plugin?

To use the Asaas Plugin, install:

• WooCommerce;
• Brazilian Market on WooCommerce.

For recurring charges, also install WooCommerce Subscriptions.

See the requirements and installation process in Installing the plugin.

Do I need to configure the Webhook manually?

No.

Starting with Asaas Plugin version 2.5, the Webhook is created and configured automatically when a valid API Key is provided.

After configuration, monitor the synchronization in WooCommerce Webhooks.

Can I use the Sandbox before publishing my store?

Yes.

Use the Sandbox to configure and test checkout, payments, and order updates before moving to Production.

See the Sandbox guide.

Can I use the same API Key in Sandbox and Production?

No.

Sandbox and Production have their own accounts, data, and independent API Keys.

Always use the key that matches the environment configured in the plugin.

See how to create and manage API keys.

I received a 401 error. What does it mean?

The 401 error indicates an authentication problem.

Check that:

• the API Key is active;
• the key was copied in full;
• the key belongs to the selected environment;
• the credential has not been revoked or deleted.

If necessary, generate a new key and update the configuration.

For a detailed diagnosis, see Common errors.

Which payment methods does the Asaas Plugin support?

The plugin lets you offer:

• Pix;
• Bank Slip (Boleto);
• Credit Card.

Each payment method can be enabled individually and has its own settings.

See the payment methods.

Can I offer installments?

Yes.

The documented limits are:

• Credit Card: up to 12 installments;
• Bank Slip: up to 60 installments.

The rules for interest, minimum amount, and number of installments are configured in the payment method itself.

Is it possible to use Payment Split?

Yes.

The Asaas Plugin lets you configure Split to automatically distribute part of the charge amounts among different Asaas wallets.

In the guide's current structure, the configuration is treated as global for new charges created by the plugin.

See the rules before enabling the feature in Payment Split in WooCommerce.

How do I create subscriptions through WooCommerce?

Use WooCommerce Subscriptions integrated with the Asaas Plugin.

WooCommerce manages the subscription cycle and Asaas processes the recurring charges.

Without WooCommerce Subscriptions, the plugin does not generate this flow.

See WooCommerce Subscriptions.

Can I receive subscriptions by Pix?

Not directly.

Subscriptions support Bank Slip and Credit Card.

When the subscription uses bank slip, the customer can also pay using the Pix QR Code available on the bank slip itself.

Does One-Click-Buy work automatically?

No.

The feature depends on card tokenization being enabled by the Asaas sales team.

After it is enabled, configure the feature in the Credit Card options.

How do I check whether my Webhooks are working?

Go to:

WooCommerce > Status > Meio de Pagamentos Asaas

The status can also be checked in the Webhook section of the payment methods.

See WooCommerce Webhooks to understand the queue states.

What should I do when the Webhook queue is interrupted?

Before reactivating the queue:

1. check the Webhook Logs;
2. identify the HTTP code or communication error;
3. fix the cause of the failure;
4. go back to WooCommerce and click Re-enable webhook queue;
5. confirm that new events are updating orders again.

Do not repeatedly reactivate a queue without fixing the cause of the interruption.

Is the customer redirected to another page to make the payment?

No.

The Asaas Plugin uses transparent checkout, allowing the buyer to complete the payment in the store itself.

Why wasn't the order updated after payment?

First check the Webhook synchronization.

An interrupted queue or a communication failure may prevent WooCommerce from receiving the charge update.

Go to WooCommerce > Status > Meio de Pagamentos Asaas and see WooCommerce Webhooks.

If the queue is active, enable the Debug Log and investigate the order in Common errors.

How do I enable the Debug log?

Go to:

WooCommerce > Settings > Payments

Select an Asaas payment method and enable Debug Log.

After reproducing the problem, check the records in:

WooCommerce > Status > Logs

Logs help identify errors returned during the creation and processing of charges.

To interpret the main scenarios, see Common errors.

Next steps

• Configure the payment methods
• Understand the billing types
• Configure subscriptions in WooCommerce
• Monitor the WooCommerce Webhooks
• See the common errors