Configure Split in WooCommerce

Configure a Split rule in the Asaas Plugin to automatically distribute part of the sales amount among other Asaas wallets.

The configuration is global: all new charges created by the Plugin use the defined Split rule.

Before you start

Confirm that:

• the Asaas Plugin is installed and connected to your account;
• your Plugin version supports Payment Split;
• you have the walletId of each account that will receive part of the amount;
• you have defined the percentage allocated to each recipient.

Split is available in the Asaas Plugin starting from version 2.2.0.

See how to retrieve the walletId.

How it works

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Configure the wallets"] --> B["Save the Split rule"]
    B --> C["Customer makes the purchase"]
    C --> D["Plugin creates the charge"]
    D --> E["Asaas applies the Split"]
    E --> F["Validate the transfers"]

    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

1. Access the payment settings

In the WordPress admin dashboard, go to:

WooCommerce > Settings > Payments

Select one of the payment methods provided by the Asaas Plugin and find the Split section.

2. Define the number of wallets

In the Split section, enter how many wallets will receive part of the amount and save the configuration.

After saving, the recipient configuration fields will be displayed.

3. Configure the recipients

Fill in the details of each wallet:

The percentage is calculated on the net amount of the charge, after the applicable fees.

4. Save and validate the configuration

Save the rule and make a test purchase.

Expected result

The charge created by the Plugin should contain the Split configuration and distribute the amounts among the defined wallets.

When the order uses Split, the split information can also be viewed in the order notes in WooCommerce.

To check the settlement of the transfers, see Paid and received Splits through the interface.

Next steps

• Learn the Payment Split rules
• Retrieve the walletId of an account
• View paid and received Splits
• See the WooCommerce FAQ
• See the Split FAQ