Payment methods

Configure and validate Bank Slip (Boleto), Pix, and Credit Card in the Asaas Plugin for WooCommerce.

Configure the payment methods in WooCommerce

Configure Bank Slip (Boleto), Pix, and Credit Card in the Asaas Plugin for WooCommerce.

Before continuing, connect your store to Asaas following the Initial settings guide.

📘
Before you start
We recommend doing the entire configuration in the Sandbox environment first. After validating that the checkout and payments work, switch the configuration to the Production environment.

Shared settings

Go to:

WooCommerce > Settings > Payments

Select an Asaas payment method and configure the required options.

View shared settings

Enable / Disable

Defines whether the payment method will be available in the store's checkout.

Title

Name displayed to the customer during checkout.

Description

Text displayed below the payment method title.

Order status for open payments

Defines which status will be assigned to the order when the payment has not yet been confirmed.

The available options are:

On hold: reduces stock and sends emails to the customer and the merchant.
Pending payment: keeps the order pending without reducing stock or sending notifications.

API

Lets you select the environment (Sandbox or Production) and enter the API Key.

If this configuration has already been done as described on the Initial settings page, you do not need to repeat it.

Webhook

The Asaas Plugin automatically configures the Webhook after the API Key is validated.

You must also provide a contact email to receive notifications if the Webhook queue is interrupted.

Notifications between Asaas and the customer

Allows Asaas to send email and SMS notifications to the customer throughout the charge lifecycle.

Debug log

Keeps records of the operations performed by the plugin, making it easier to identify errors and get technical support.

We recommend keeping this option enabled.

Validation flow

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Enable the payment method"] --> B["Configure in the Sandbox"]
B --> C["Save the settings"]
C --> D["Make a test purchase"]
D --> E["Validate the charge in Asaas"]
E --> F["Receive the update via Webhook"]
F --> G["Confirm the order in WooCommerce"]

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 validacao
class G sucesso

linkStyle default stroke:#94A3B8,stroke-width:2px

If the order is not updated after a change in the charge, check the Debug log and the queue status in WooCommerce Webhooks.

Configure Bank Slip (Boleto)

The bank slip supports one-time or installment charges, as well as due date and validity settings.

💡
When to use
Use the bank slip when you want to offer one-time payments or installments of up to 60 installments.

View Bank Slip settings

Installments

Lets you configure between 0 and 60 installments.

Interest per installment

Defines the interest applied for each number of installments.

Minimum amount per installment

Defines the lowest amount allowed for each installment.

Days to due date

Number of days until the bank slip is due after the purchase.

Validity period

Number of days the bank slip will remain available after the due date.

If the field is left empty, the bank slip will not be removed automatically.

Payment Split

Lets you automatically split the amount received among different Asaas wallets.

This feature is available starting with Asaas Plugin version 2.2.0.

Configure Pix

Pix lets you define the charge expiration and the display of Pix Copy and Paste.

⚡
When to use
Pix is recommended for immediate payments, offering automatic confirmation after settlement.

View Pix settings

Expiration period

Defines for how many days the QR Code will be available for payment.

After this period, the charge will be removed.

Pix Copy and Paste

When enabled, the Pix Copy and Paste code will be displayed in addition to the QR Code to make payment easier.

Payment Split

Lets you automatically split the amounts received among different Asaas wallets.

This feature is available starting with Asaas Plugin version 2.2.0.

Configure Credit Card

Credit Card lets you configure installments, minimum order amount, anticipation, and One-click purchase.

💳
When to use
Use Credit Card when you want to offer one-time payments, installments, or features such as One-click purchase.

View Credit Card settings

Minimum order amount

Defines the minimum amount for this payment method to be displayed.

If you enter 0, Credit Card will be available for all orders.

Installments

Lets you configure between 0 and 12 installments.

Interest per installment

Defines the interest applied for each number of installments.

Minimum amount per installment

Defines the lowest amount allowed for each installment.

Receivables anticipation

Automatically requests anticipation of charges paid by Credit Card, following the Asaas account rules.

Payment Split

Lets you automatically split the amounts received among different Asaas wallets.

One-click purchase

Lets you store the customer's card for future purchases.

This feature depends on card tokenization being enabled by the Asaas sales team.

About Payment Split

The Split option appears in the payment method settings, but the rule currently documented for the Asaas Plugin is global.

This means that all new charges created by the plugin use the defined Split configuration. Changes do not modify existing charges.

Before enabling the feature, see Payment Split in WooCommerce.

Validate the checkout

After configuring each payment method, validate the behavior in the Sandbox.

Payment method	During checkout	After the charge is generated	After confirmation
Bank Slip	The customer selects bank slip and completes the order.	The order receives the status configured for open payments.	The Webhook updates the order after the payment is confirmed.
Pix	The customer sees the QR Code and, when enabled, Pix Copy and Paste.	The charge remains available until the end of the expiration period.	The Webhook updates the order after settlement.
Credit Card	The customer enters the card details and completes the order.	The order follows the result of the payment processing.	The order is updated according to the confirmation received by the plugin.

During the test:

Generate an order in the Sandbox for each enabled payment method.
Confirm the title and description shown at checkout.
Validate the Order status for open payments.
For bank slip, validate Days to due date and Validity period.
For Pix, validate the Expiration period and the display of Pix Copy and Paste, when enabled.
For Credit Card, validate the minimum order amount and the installment options.
If you use Split, confirm the distribution of amounts.
If the order is not updated, check the Debug log and the Webhook queue.

✅
Criteria for moving to Production
Move to Production only after each enabled payment method generates the charge correctly, displays the expected information at checkout, and updates the order after the payment is confirmed.

📘
Best practices

Configure the plugin in the Sandbox environment first.

Validate all payment methods before moving to Production.

Keep the Debug log enabled during rollout.

Use only the payment methods your operation needs.

If you use Payment Split, validate the distribution of amounts before making the store available to customers.

After any important configuration change, make a test purchase to confirm that the checkout works.

📚
Continue the configuration
After configuring the payment methods, also see:

Initial settings — connecting the store to Asaas.

Billing types — differences between one-time, installment, and recurring charges.

Webhooks — automatic synchronization between WooCommerce and Asaas.

Common errors — solving the main integration problems.

Next steps

Updated 3 days ago

Did this page help you?