WooCommerce
Understand when to use the Asaas plugin for WooCommerce, which flows it supports, and which pages to check to install, configure, and troubleshoot it.
Use the Asaas Plugin for WooCommerce to receive payments by Pix, bank slip (boleto), and credit card directly in your WordPress store's checkout.
The integration also lets you configure installments, subscriptions, Payment Split, One-Click-Buy, and automatic anticipation, depending on the flow used.
Choose what to configure
| Need | See |
|---|---|
| Install the Asaas Plugin on WordPress | Installing the plugin |
| Connect the store to the Asaas account and configure Sandbox or Production | Initial settings |
| Configure Pix, bank slip, or credit card | Payment methods |
| Choose between one-time charge, installments, or recurrence | Billing types |
| Create recurring charges with WooCommerce Subscriptions | WooCommerce Subscriptions |
| Split sales amounts between Asaas wallets | Payment Split in WooCommerce |
| Understand order synchronization | WooCommerce Webhooks |
| Investigate plugin failures | Common errors |
| See frequently asked questions | FAQ - WooCommerce |
Available features
| Feature | How to use |
|---|---|
| Transparent checkout | The buyer completes the payment on your own site. |
| Pix, bank slip, and credit card | Enable only the payment methods your operation needs. |
| Installments and interest | Configure the number of installments, minimum amount, and interest according to the payment method. |
| Payment Split | Automatically distribute part of the charge amount among other Asaas wallets. |
| Subscriptions | Use WooCommerce Subscriptions for recurring charges by bank slip or credit card. |
| One-Click-Buy | Allow future purchases with a stored card after tokenization is enabled by the Asaas sales team. |
| Automatic anticipation | Automatically request anticipation of credit card charges, according to the Asaas account rules. |
Before you start
To use the plugin, your store needs:
- WordPress;
- WooCommerce;
- Brazilian Market on WooCommerce;
- an Asaas account;
- administrative access to WordPress.
For recurring charges, also install WooCommerce Subscriptions.
If your operation uses One-Click-Buy, request card tokenization enablement from the Asaas sales team in advance.
The technical version requirements and the installation process are detailed in Installing the plugin.
Configuration flow
%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Install the plugin"] --> B["Connect the Asaas account"]
B --> C["Choose the payment methods"]
C --> D["Configure the operation rules"]
D --> E["Make a purchase in the Sandbox"]
E --> F["Validate the charge creation"]
F --> G["Receive the update via Webhook"]
G --> H["Go live in Production"]
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,G validacao
class H sucesso
linkStyle default stroke:#94A3B8,stroke-width:2px
First configure the store in the Sandbox. After validating the checkout, the charges, and the order updates, switch the integration to Production.
Webhooks
The Asaas Plugin uses Webhooks to synchronize WooCommerce orders with charge changes in Asaas.
Starting with plugin version 2.5, the Webhook is created automatically when a valid API Key is configured. Do not implement polling to track order status.
If a paid order is not updated, check the queue status and the recovery procedures in WooCommerce Webhooks.
Next steps
Updated 3 days ago