Split Settlement

Fan a settled account across multiple beneficiaries.

Fan a settled account's net across multiple beneficiaries instead of a single sweep. Legs are percentage (basis points) or flat kobo, paid in priority order.

Percentages are basis points

1% = 100 bps; 80% = 8000. The first (lowest-priority) leg absorbs any rounding remainder so legs always sum to exactly net.

Over-allocation aborts the whole settlement

If flat legs exceed the net collected, the settlement is skipped entirely (never partial) until you fix the plan. Keep flat amounts well under expected net.

Empty list = single sweep

Sending an empty splits array clears the plan and reverts to the default single sweep.

get/api/v1/settings/splits

GET /api/v1/settings/splits

Requires Bearer token

Responses

200OK

GET /api/v1/settings/splits

curl -X GET "https://api.xental.online/api/v1/settings/splits" \
  -H "Authorization: Bearer <API_TOKEN>"

put/api/v1/settings/splits

PUT /api/v1/settings/splits

Requires Bearer token

Body parameters

splitsSplitLegRequest[]optional

Responses

200OK

PUT /api/v1/settings/splits

curl -X PUT "https://api.xental.online/api/v1/settings/splits" \
  -H "Authorization: Bearer <API_TOKEN>"