Woocommerce
Use the Asaas plugin for WooCommerce to receive payments in your WordPress store through the Asaas payment gateway.
WooCommerce is an open-source e-commerce plugin for WordPress. It transforms a WordPress site into an online store, complete with products, cart, checkout, and orders.
The Asaas plugin for WooCommerce connects that store to Asaas, allowing Asaas to operate as the payment processor at checkout. Use this page as a starting point to understand when to use the plugin, which flows it supports, and where to go next for configuration.
When to use the plugin
Use the Asaas plugin for WooCommerce when you need to:
- Offer transparent checkout, where the customer pays without leaving your site.
- Accept one-time credit card payments.
- Accept installment payments via bank slip (boleto) and credit card.
- Customize interest rates based on the number of installments.
- Configure payment splitting (automatic distribution of received amounts across selected wallets).
- Generate subscriptions through WooCommerce Subscriptions via bank slip or credit card.
- Offer One-Click-Buy so customers can store credit card data for future payments, when tokenization has been enabled by the sales team.
- Enable automatic anticipation on credit card charges.
Prerequisites
Before setting up the integration:
- Have a WordPress store with WooCommerce installed.
- Install the Asaas plugin for WooCommerce by following the Installing the plugin guide.
- Configure the plugin's initial settings under Initial settings.
- Request tokenization activation from the sales team if you plan to use One-Click-Buy.
- Activate WooCommerce Subscriptions if you plan to generate subscriptions through the plugin.
Integration flow
The main integration flow follows this order:
- Install the plugin. Add the Asaas plugin to your WooCommerce store to make payment settings available.
- Configure the Asaas account. Enter the credentials and preferences needed to connect the store to Asaas.
- Choose payment methods. Define which payment options will be offered at checkout, such as credit card and bank slip.
- Configure installment rules. Set when to offer installments and which interest rates to apply per number of installments.
- Optional: configure payment splitting. Apply a global rule to send a percentage of sales to selected wallets.
- Optional: configure subscriptions. Use WooCommerce Subscriptions to generate recurring charges via bank slip or credit card.
- Test checkout. Validate that customers can complete a purchase without leaving the site and that orders behave as expected in WooCommerce.
Key settings
| Setting | When to use | Operational impact |
|---|---|---|
| Payment methods | When you want to choose which payment options appear at checkout. | Defines the options the customer sees when finalizing a purchase. |
| Installments and interest | When you sell via bank slip or installment credit card. | Changes the final amount based on the configured number of installments. |
| Payment splitting | When part of the sale amount must be automatically sent to partners or other wallets. | Divides sale amounts according to the configured global rule. |
| WooCommerce Subscriptions | When you sell recurring subscriptions. | Allows subscriptions to be generated via bank slip or credit card through the plugin. |
| One-Click-Buy | When you want to make future purchases easier with a saved credit card. | Requires prior tokenization activation with the sales team. |
| Automatic anticipation | When you want to anticipate credit card charges. | Applies automatic anticipation to configured credit card charges. |
Important behaviors
- Transparent checkout: the customer completes payment on your site, with no redirection to an external page.
- CPF/CNPJ validation: the plugin validates whether the document entered by the customer is valid before proceeding with payment.
- Payment splitting: the configuration is global; every sale made in the e-commerce store sends a percentage to the selected wallets.
- Tokenization: storing card data for One-Click-Buy requires prior activation with the sales team.
- Subscriptions: generating subscriptions through the plugin requires WooCommerce Subscriptions.
Troubleshooting
If the integration does not work as expected:
- Review the plugin's initial settings under Initial settings.
- Check known issues under Common errors.
- Consult Payment method and Payment options to review your payment method configuration.
- If the issue involves events or asynchronous updates, refer to the Webhooks documentation.