Manage sub-entity settlements
Beta
Last updated: March 25, 2026
When Checkout.com captures funds from customers on the behalf of your sub-entities, we can transfer the funds to each sub-entity's bank account as a settlement payout.
- When Checkout.com captures a payment, the funds enter your sub-entity's Pending balance. We set a date for when the funds become available. When funds become available, they can be settled or used for other use cases such as payouts on your Checkout.com account.
- Every day at midnight in your sub-entity's settlement time zone, the funds in their Pending balance that have become available are batched and move to their Available balance.
- When the sub-entity's next settlement is generated, the funds move from their Available to their Payable balance.
- The settlement is paid out from their Payable balance to the sub-entity's bank account according to their settlement schedule. Alternatively, you can instruct a payout on demand.
The sub-entity's settlement time zone determines when payments move from Pending to Available. By default, payments are batched for an entire day, from midnight to the following midnight, in the sub-entity’s local time zone.
Payments processed on non-business days are included in the batch on the next business day.
If the sub-entity's settlement time zone is set to UTC, their settlements are generated at 2:00 AM UTC. For all other time zones, settlements are generated at 5:00 AM local time, based on the regional Checkout.com entity you're contracted with. Settlements are then paid out at the configured settlement schedule.
You can schedule for your sub-entity to receive settlements at one of the following frequencies in their preferred time zone:
- Daily – Weekdays, excluding non-business days
- Weekly – A weekday of choice, excluding non-business days
- Monthly – First or 15th of each month
If a scheduled settlement is due to be paid out on a non-business day in the selected settlement time zone, the funds are paid out on the following business day instead.
The settlement speed is the period between time of sale and when the funds in your sub-entity's Pending balance become available. This may range from a few minutes to a few days.
Settlement speed is usually represented as T+X, where:
- T is the transaction date.
- X is the number of business days after the transaction date that the funds become available.
For example, a payment is processed on Tuesday and the currency’s standard settlement speed is T+2. The funds become available on Thursday, and are paid out in the next settlement. If your sub-entity's settlement schedule is:
- Daily – The funds are paid out on Thursday.
- Weekly on Fridays – The funds are paid out on Friday.
When funds are available and ready for settlement, all payments processed on that business day are batched and move from Pending to your Available balance shortly after midnight. Payments processed on non-business days are included in the batch on the next business day.
A currency holiday is a day when local banks do not convert specific currencies.
Currency holidays and non-business days may delay the standard settlement speed. Currency holidays are set by the settlement currency (US dollar).
You can set up webhooks to be notified about settlement events:
Call the Retrieve a sub-entity's payout schedule endpoint, and provide the sub-entity ID as the {id} path parameter.
Information
Your base URL's {prefix} value is unique to your account and environment. To learn how to retrieve your base URLs for the sandbox and production environments, see API endpoints.
get
https://{prefix}.api.checkout.com/accounts/entities/{id}/payout-schedules
Call the Update a sub-entity's payout schedule endpoint, and provide the sub-entity ID as the {id} path parameter.
In the request body, provide at least one of the following fields, and replace {ISO} with USD:
{ISO}.enabled- Indicates whether the payout schedule is enabled.{ISO}.threshold– The minimum available balance on the account for a payout. If the available balance is less than the threshold, then the payout is not instructed.{ISO}.payment_instrument_id- The payment instrument ID used for payouts on this schedule.{ISO}.recurrence.frequency- The frequency at which funds are paid out to the sub-entity.
Information
Your base URL's {prefix} value is unique to your account and environment. To learn how to retrieve your base URLs for the sandbox and production environments, see API endpoints.
put
https://{prefix}.api.checkout.com/accounts/entities/{id}/payout-schedules