Billing types

Understand when to use one-time, installment, or recurring charges and which rules apply to each payment method.

Choose the billing type in WooCommerce

Define how your store will charge each sale before configuring the payment methods in the Asaas Plugin.

You can use a one-time charge, installments, or a recurring charge. The availability of Bank Slip, Pix, and Credit Card depends on the chosen model.

💡
How to choose?
Before configuring your store, define whether the sale will be made in a single charge, in installments, or on a recurring basis. This decision directly affects the customer experience during checkout.

Compare the billing types

Billing type	When to use	Payment methods	Limit
One-time charge	Single purchases	Bank Slip, Pix, and Credit Card	—
Card installments	Split a purchase into card installments	Credit Card	Up to 12x
Bank Slip installments	Generate different bank slips for an installment purchase	Bank Slip	Up to 60x
Recurring charge	Monthly fees, plans, and subscriptions	Bank Slip and Credit Card	According to the subscription settings

Compatibility

Billing type	Bank Slip	Pix	Credit Card
One-time	✅	✅	✅
Installments	✅ Up to 60x	❌	✅ Up to 12x
Recurring	✅	⚠️ Via bank slip	✅

📘
Paying subscriptions 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 the payment to be made using this method.

Understand each model

One-time charge

Use it for a purchase or service paid only once.

The charge can use Bank Slip, Pix, or Credit Card.

Installments

Use it when the purchase amount will be split into installments.

The Asaas Plugin supports:

Credit Card: up to 12 installments;
Bank Slip: up to 60 installments.

Pix is not available as an installment payment method.

The rules for the number of installments, minimum amount, and interest are configured in Payment methods.

Recurring charge

Use it for monthly fees, plans, subscription clubs, and other periodic payments.

Recurring charges depend on WooCommerce Subscriptions and can use:

Bank Slip;
Credit Card;
Pix indirectly, through the QR Code available on the bank slip.

To configure this flow, see WooCommerce Subscriptions.

Configuration flow

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Choose the billing type"] --> B["Define the payment methods"]
B --> C["Configure installments, if applicable"]
C --> D["Configure subscriptions, if applicable"]
D --> E["Make purchases in the Sandbox"]
E --> F["Validate payments and orders"]

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

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

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

Changes made to the billing type affect new purchases. Orders already created are not changed automatically.

Examples

Scenario	Billing type
Sale of a physical product	One-time charge
Laptop paid in 10 installments	Card installments
Course paid in bank slip installments	Bank Slip installments
Gym, SaaS, or streaming	Recurring charge

💡
Recommendations

Validate the installment limits before making the store available.

Show the customer the number of installments and the interest applied during checkout.

Use recurring charges only for ongoing products or services.

Keep the identifier returned by Asaas to make queries, reconciliation, and support easier.

Always make test purchases after changing installment or recurrence rules.

Track updates via Webhook

The Asaas Plugin uses Webhooks to keep orders synchronized with charge changes.

To track confirmations, due dates, refunds, and other relevant changes, use Webhook synchronization instead of periodic queries.

See the WooCommerce Webhooks.

📚
Continue the configuration
After defining the billing type, also see:

Payment method

Subscriptions

Webhooks

Initial settings

Common errors

Next steps

Updated 16 days ago

Did this page help you?