Initial Settings
Activating payment methods
After installing the Asaas Plugin for WooCommerce, it is necessary to connect your store to your Asaas account and enable the payment methods that will be made available to your customers.
Access the WooCommerce > Settings > Payments menu.
On this screen, all payment methods made available by the Asaas Plugin will be displayed, allowing each one to be activated or deactivated according to your store’s needs.
Each payment method has its own settings, such as installments, notifications, payment split, and other specific options.
Environments and API Key
Before configuring the payment methods, it is necessary to connect your WordPress store to your Asaas account using an API Key.
If you want to run tests before putting your store into production, use the Sandbox environment.
Create your account at:
To process real charges, use the Production environment:
ImportantThe Sandbox and Production environments are completely independent.
Each environment has its own customers, charges, settings, and API Keys. An API Key created in Sandbox will not work in Production and vice versa.
After defining the environment, generate a corresponding API Key.
In your Asaas account, access:
User menu → Integrations → Generate new API Key
Copy the entire generated key.
Configuring the API Key
After copying your API Key, access any of the payment methods made available by the Asaas Plugin and locate the API section.
Configure the following fields:
- Environment: select Sandbox for tests or Production for real charges.
- API Key: paste exactly the key generated in your Asaas account, including all characters.
After entering the data, the plugin will automatically validate the key.
In case of success, the following message will be displayed:
If validation fails, confirm:
- whether the selected environment corresponds to the API Key environment;
- whether the API Key was copied in full;
- whether the key is still active in the Asaas account.
After validation, save the changes.
Operational impacts
AttentionUsing an API Key incompatible with the selected environment will prevent charges from being created by the integration.
We recommend performing all tests using the Sandbox environment before configuring your store in Production.
Protect your API KeyThe API Key has access to your Asaas account and allows financial operations to be executed.
- Never share your API Key in support interactions.
- Do not publish the key in public repositories.
- Store it only in secure environments.
Shared configuration
API Key and WebhookThe API Key and Webhook configuration appears in all payment methods of the Asaas Plugin, but it is shared among all of them.
Therefore, you only need to perform this configuration once.
To understand how automatic order synchronization and webhook configuration work, see the Webhooks page.
Updated 20 days ago