DiscordStatus
Guias / Guides

Installing the plugin


This page presents the prerequisites for using the Asaas Plugin for WooCommerce and the installation process in WordPress.

After completing the installation, proceed to the Initial settings page, where the store will be connected to your Asaas account through the API Key.

Before installing

Before starting the installation, confirm that:

  • your store uses WordPress;
  • WooCommerce is installed and working;
  • you have an Asaas account (Sandbox or Production);
  • you have administrator permissions in WordPress to install plugins.

If you intend to sell subscriptions, you will also need to use the WooCommerce Subscriptions plugin.

Minimum requirements

To ensure compatibility with the current versions of the plugin and receive future updates, we recommend using at least:

  • PHP: 7.0 or higher;
  • WordPress: 4.4 or higher;
  • WooCommerce: 5.0 or higher.

If you use recurring charges, it will also be necessary to install WooCommerce Subscriptions.

Required plugins

The operation of the Asaas Plugin depends on other plugins from the WooCommerce ecosystem.

Some are mandatory and others depend on the resources used by your store.

PluginMandatoryWhen to use
WooCommerceYesResponsible for turning WordPress into an online store, allowing product registration, orders, shopping cart, and checkout.
Brazilian Market on WooCommerceYesAdds fields used in the Brazilian market to the checkout, such as CPF, CNPJ, phone, ZIP code, and address.
WooCommerce SubscriptionsOnly for subscriptionsRequired for recurring subscription sales using the Asaas Plugin.

When installing the Asaas Plugin, WordPress itself may automatically suggest the installation of the compatible mandatory and optional plugins.

Installing the Asaas Plugin

Installing the Asaas Plugin is simple and can be done directly through the WordPress administrative panel.

📘

Installation through the official WordPress plugins page

In the WordPress Plugins menu, search for Asaas.

Locate the Asaas Payment Method for WooCommerce plugin and click Install now.

After installation, 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.

After installation

After activating the plugin:

  • the Asaas payment method will be made available in the WooCommerce settings;
  • it will be possible to connect your store to the Asaas account using an API Key;
  • payment methods can be enabled individually;
  • the webhook will be configured during the initial configuration step of the integration.

Best practices

  • keep the Asaas Plugin always updated;
  • also keep WordPress and WooCommerce updated;
  • perform the first tests using the Sandbox environment;
  • back up the store before performing major updates;
  • use only plugins compatible with the installed WooCommerce version.

Next steps

After completing the plugin installation:

  1. Configure the environment (Sandbox or Production);
  2. Enter your API Key;
  3. Validate the connection with Asaas;
  4. Configure the desired payment methods;
  5. Perform checkout tests;
  6. Publish the integration in production.

Related content

  • Initial settings
  • Payment method
  • Charge methods
  • Webhooks
  • Common errors