Payment Split in WooCommerce

Use Payment Split to automatically distribute part of the sales amounts among other Asaas wallets.

In the Asaas Plugin for WooCommerce, the configuration is associated with the new charges created by the plugin. You do not need to define the Split for each order.

Before you start

Before configuring:

• connect the Asaas Plugin to your account;
• use a plugin version that supports Split;
• confirm that each recipient has an Asaas account;
• obtain the walletId of the accounts that will receive the transfers;
• define how the amount will be distributed;
• use the Sandbox to validate the configuration before operating in Production.

Do not provide as a recipient the walletId of the account that creates the charge. The net amount not distributed remains in that account.

Percentage Split is calculated on the net amount of the charge (netValue), after applicable fees.

See the general Payment Split rules.

How it works

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Configure the Split"] --> B["Customer makes the purchase"]
B --> C["Plugin creates the charge with Split"]
C --> D["Customer makes the payment"]
D --> E["Calculate the net amount"]
E --> F["Settle the Splits"]

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

The Split configuration is sent by the plugin when the charge is created. After receipt, Asaas calculates and processes the transfers according to the linked rule.

1. Access the Split configuration

In WordPress, go to:

WooCommerce > Settings > Payments

Select one of the Asaas payment methods and locate the Split section.

2. Configure the recipients

Define the wallets that will receive part of the amounts and the distribution rule used by the operation.

Before saving, confirm:

• that the walletId values belong to the expected recipients;
• that no recipient uses the walletId of the issuing account itself;
• that the distributed amounts are compatible with the available net amount;
• that the distribution matches the operation's business rule.

Save the changes after reviewing the configuration.

3. Understand when the change will be applied

The configuration applies to new charges created by the Asaas Plugin.

Changing the Split:

• affects charges created after the change;
• does not change charges that already exist;
• does not recalculate Splits linked to previous orders.

4. Validate in the Sandbox

Create a purchase using one of the enabled payment methods and confirm that:

1. the charge was created in Asaas;
2. the expected recipients are linked to the Split;
3. the amounts match the configured rule;
4. after payment, the Splits are processed as expected.

Expected result

New Asaas Plugin charges should be created with the defined Split configuration and, after receipt, the amounts should be distributed among the configured wallets.

For an operational check, see the paid and received Splits in the Asaas interface.

See the Splits in the interface.

Track settlement

For automated Split tracking in your own integration, use the event:

PAYMENT_SPLIT_DONE

The event is triggered when a specific Split is settled. When a charge has more than one recipient, several events may occur, one for each settled Split.

Use Webhooks for this tracking instead of periodic queries.

See the events for payments.

Next steps

• See the Payment Split rules
• Configure the payment methods
• See the Splits in the interface
• Track the events for payments
• See the common WooCommerce errors