Installing the plugin

How to use Asaas in WooCommerce.

Install the Asaas Plugin for WooCommerce on WordPress to make Asaas payment methods available in your store.

After activating the plugin, go to the initial settings to connect the store to your Asaas account with an API Key.

Before you start

Confirm the minimum installation requirements:

RequirementMinimum version
WordPress6.2
PHP7.4
WooCommerce8.2

You also need:

  • administrative access to WordPress;
  • WooCommerce installed and active;
  • Brazilian Market on WooCommerce installed and active;
  • an Asaas account to configure the integration after installation.

If the store uses recurring charges, also install WooCommerce Subscriptions.

Install the plugin

📘

Installation from the official WordPress plugin directory

In the WordPress admin panel:

  1. Go to Plugins > Add New.
  2. Search for Meio de Pagamento Asaas para o WooCommerce.
  3. Click Install Now.

After the installation is complete, click Activate.

🚧

Enable automatic plugin updates

We recommend keeping automatic updates enabled to always use the latest version of the Asaas Plugin, ensuring access to the latest improvements, security fixes, and compatibility with new WooCommerce versions.

Expected result

The Asaas Plugin for WooCommerce should appear as active in WordPress, and the Asaas payment methods should be available in the WooCommerce settings.

The installation does not yet connect the store to Asaas. This connection will be made in the next step with an API Key.

After installation

Go to Initial settings to:

  • choose between Sandbox and Production;
  • enter the API Key;
  • connect the store to the Asaas account;
  • enable the required payment methods.

Starting with Asaas Plugin version 2.5, the Webhook is created automatically when a valid API Key is configured. You do not need to register it manually to start the integration.

Next steps


Did this page help you?