Billing types

Understand when to use one-time, installment, or recurring charges and which rules to apply for each payment method.

Correctly choosing the charge method is one of the main steps in configuring the Asaas Plugin for WooCommerce.

Each type of charge serves a different sales scenario and has specific rules regarding the supported payment methods.

💡
How to choose?
Before configuring your store, define whether the sale will be made as a single, installment, or recurring charge. This decision directly impacts the customer experience during checkout.

Concepts

The main available charge models are:

Type	Description
One-time charge	Single charge generated for a specific purchase or service.
Installment plan	Division of the total amount into several installments, according to the chosen payment method.
Recurring charge	Charges generated automatically in cycles for monthly fees, plans, and subscriptions.
Pix via bank slip	The customer receives a bank slip and can make the payment using the Pix QR Code available in the document.

When to use each type

Charge type	Recommended for	Payment methods	Limit
One-time charge	One-time purchases	Bank Slip, Pix, and Credit Card	—
Credit Card Installment Plan	Higher-value purchases	Credit Card	Up to 12x
Bank Slip Installment Plan	Installments by bank slips	Bank Slip	Up to 60x
Recurring charge	Monthly fees, plans, and subscriptions	Bank Slip and Credit Card	According to the subscription configuration

Configuration flow

After installing and configuring the Asaas Plugin, we recommend following this order:

Choose the charge type that represents your operation.
Define which payment methods will be made available.
Configure installments, when applicable.
If using subscriptions, configure WooCommerce Subscriptions.
Make test purchases before publishing the store.

📘
Important
The charge type defines only how payments will be generated. Installment rules, notifications, and Webhooks continue to be configured normally in the Asaas Plugin.

Compatibility between charges and payments

Charge method	Bank Slip	Pix	Credit Card
One-time	✅	✅	✅
Installment	✅ (up to 60x)	❌	✅ (up to 12x)
Recurring	✅	❌*	✅

📘
Subscription payments via Pix
Subscriptions do not have Pix as a direct payment method.
If you want the customer to pay using Pix, configure the subscription with Bank Slip. The bank slip generated by Asaas will display a Pix QR Code, allowing payment to be made using this method.

Business rules

When using charge methods, consider that:

one-time charges are available for all payment methods;
credit card installment plans allow up to 12 installments;
bank slip installment plans allow up to 60 installments;
recurring charges use only bank slip or credit card;
subscriptions depend on the WooCommerce Subscriptions plugin;
changes to the charge method do not affect orders already created.

Best practices

💡
Recommendations

Validate the installment limits before making the store available.

Present the number of installments and the applied interest to the customer during checkout.

Use recurring charges only for continuous products or services.

Store the identifier returned by Asaas to facilitate consultations, reconciliation, and support.

Always make test purchases after changing installment or recurrence rules.

Usage examples

Scenario	Recommended method
Sale of a physical product	One-time charge
Notebook paid in 10 installments	Credit Card Installment Plan
Course paid in bank slip installments	Bank Slip Installment Plan
Gym, SaaS, or streaming	Recurring charge

📚
Continue the configuration
After defining the charge method, also see:

Payment method

Subscriptions

Webhooks

Initial settings

Common errors