Split in Pluga

How to use payment split in a simple way through Pluga

Configure Split in Pluga

Create charges with Split in Asaas through a Pluga automation, without developing your own integration.

The source tool can be Google Sheets or another system compatible with the chosen automation.

Before you start

Have:

an Asaas account;
a Pluga account;
a source tool for the charge data;
access to the Asaas account that will create the charges;
the recipients and the split rule defined.

In Pluga, Split can use registered subaccounts or walletId, depending on the chosen automation model.

If you use walletId, see how to retrieve the wallet identifier.

How it works

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Prepare the data"] --> B["Configure the trigger"]
    B --> C["Connect Asaas"]
    C --> D["Map the charge"]
    D --> E["Configure the Split"]
    E --> F["Finish the automation"]
    F --> G["Create a test charge"]
    G --> H["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,F,G validacao
    class H sucesso

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

1. Prepare the data source

Organize the data needed to create the charge and configure the Split.

In a spreadsheet, for example, you can separate:

Group	Examples
Customer	Name, email and phone
Charge	Amount, due date and description
Split	Recipient, split type and amount

Include the walletId when it is used to identify the recipient.

2. Configure the automation

In the Pluga dashboard:

create a new automation;
choose the source tool, such as Google Sheets;
select the spreadsheet or resource that contains the data;
define the trigger that will start the charge creation.

Use a trigger that is only fired when all the required data is filled in.

3. Connect Asaas

Select Asaas as the destination tool and choose the charge creation action.

Connect the Asaas account following the authentication flow presented by Pluga.

❗️
Security risk
Protect the key used by the automation and do not expose it in spreadsheets, repositories or other places without access control.

4. Map the charge data

Map the data from the source tool to the fields used to create the charge.

Review in particular:

customer;
amount;
due date;
payment method;
sale reference, when used.

The available fields may vary depending on the action and automation model selected in Pluga.

5. Configure the Split

In the Split de Pagamento (Payment Split) option, enable payment splitting.

Choose how to identify the recipients:

already registered subaccounts; or
walletId.

Then, define the amount allocated to each recipient as:

fixed amount; or
percentage.

⚠️
Attention
The general Split rules still apply to charges created by Pluga.
The percentage is calculated on the net amount of the charge, and the walletId of the issuing account itself must not be used as a recipient.

See the Payment Split rules.

6. Finish and test the automation

Review the mappings and finish the automation in Pluga.

Fire the trigger with test data and confirm whether the charge was created in Asaas with the expected recipients and amounts.

Expected result

Pluga creates the charge in Asaas with the Split configuration defined in the automation.

After the payment is received, Asaas processes the transfers according to the charge's rules.

Track the Splits

For operational validation, check paid and received Splits directly in the Asaas interface.

View Splits through the interface.

If your operation needs automated tracking, use payment Webhooks. The PAYMENT_SPLIT_DONE event indicates the settlement of a specific Split.

See Payment events.

Next steps

Updated 2 days ago

Did this page help you?