Split query via interface

View Splits through the interface

Track paid and received Splits directly in the Asaas application.

Use the interface for operational queries, applying filters and manual CSV export. For automations, use the features available via API.

📘

Recommendation

Use the interface for operational queries, one-off analyses and manual data export.

For automated queries, internal integrations or your own dashboards, use the features available via API.

Choose how to query

NeedUse
Check paid or received SplitsInterface
Find a Split by charge, account or periodInterface
Export data to CSVInterface
Query Split statistics programmaticallyAPI
Feed dashboards or automated reportsAPI
Track settlements in real timeWebhooks

How to access

The Split de pagamentos (Payment Split) option is displayed in the side menu when the account has Splits configured.

To query:

  1. log in to your Asaas account;
  2. in the side menu, select Split de pagamentos (Payment Split);
  3. choose Splits pagos (Paid Splits) or Splits recebidos (Received Splits);
  4. use the search or the filters;
  5. export the data to CSV, if needed.

View paid and received Splits

Choose the tab according to the account's role in the operation:

TabWhat it shows
Splits pagos (Paid Splits)Amounts your account must transfer or has already transferred to other Asaas accounts
Splits recebidos (Received Splits)Amounts your account is due to receive or has already received from other Asaas accounts

The tables show information such as:

  • invoice number;
  • origin or destination account;
  • charge receipt date;
  • Split payment date;
  • amount;
  • status.

Filter the results

Use the filters to find a specific operation or narrow down the query period.

Depending on the tab, filters such as the following are available:

  • account name;
  • charge receipt date;
  • Split payment date;
  • external identifier of the charge;
  • invoice number;
  • Split status;
  • advanced filters.

Interpret the Split status

The interface uses simplified statuses for operational tracking:

StatusHow to interpret it
A pagar (To pay)Split scheduled to be paid by your account
Pago (Paid)Split paid by your account
A receber (To receive)Split scheduled to be received by your account
Recebido (Received)Split received by your account
Pendente (Pending)Split still being processed
Cancelado (Canceled)Split canceled
📘

Technical statuses

In API integrations, technical split statuses may be presented with names such as PENDING, AWAITING_CREDIT, DONE, CANCELLED, REFUSED and REFUNDED.

When reconciling interface data with API data, take into account the difference between the status displayed in the interface and the technical status returned by the API.

Export the data to CSV

Use the export for manual reconciliations, spreadsheet analysis or sharing with finance teams.

🚧

Attention

Before exporting the CSV, apply the desired filters.

The export should reflect the data set displayed or selected in the query, according to the filters applied on the screen.

Query statistics via API

For automated queries, use:

GET /v3/finance/split/statistics

This endpoint retrieves Split statistics and can be used to feed internal reports or dashboards.

See the Retrieve split values endpoint.

🚧

Important

GET calls must be made with an empty body.

If the request body is filled in, the API may return a 403 Forbidden error.

Example:

curl --request GET \
  --url https://api-sandbox.asaas.com/v3/finance/split/statistics \
  --header 'accept: application/json' \
  --header 'access_token: $ASAAS_API_KEY'
📘

Recommendation

Use the API when you need to automate queries or feed internal reports.

Use the interface when you need to visually validate information, apply manual filters or export one-off data to CSV.

To track the settlement of a Split in real time, use the PAYMENT_SPLIT_DONE event instead of making recurring queries.

See Payment events.

Interface availability

📘

BaaS accounts

This option is not available for BaaS accounts, since the customer does not have access to the web application.

For BaaS operations, query the necessary data via API or through the flows defined for the integration.

If the Split de pagamentos (Payment Split) menu does not appear, check whether the account has Splits configured and whether the user has access to financial information.

Query issues

SituationWhat to do
Split does not appearReview the filters and confirm whether the charge has a Split
Amount different from expectedCheck the net amount, the configuration and possible refunds, anticipations or cancellations
Split remains pendingCheck the charge processing and possible blocks
CSV does not show the expected dataReview the period and filters before exporting
API returns 401Validate the API Key and the environment used
API returns 403 when querying statisticsSend the GET request without a body

Next steps


Did this page help you?