Process sub-entity payments
Beta
Last updated: September 16, 2026
After your sub-entity passes onboarding checks and has payment capabilities enabled, Checkout.com can start processing payments via your platform.
The following payment methods are supported:
- American Express
- Discover
- Visa
- Mastercard
- ACH Direct Debit
- Apple Pay
- Cartes Bancaires
- Google Pay
- PINless Debit
You can choose to charge a mark-up as part of the fees Checkout.com charges to a sub-entity. You can use one of three following types of mark-up:
- Fixed - a fixed mark-up, charged per payment in minor currency units.
- Variable - a variable mark-up, charged as a percentage of the payment amount.
- Compound - a compound mark-up, charged as a fixed amount per payment combined with a percentage of the payment amount.
If you do not wish to charge a mark-up, do not include it in the request's amount_allocations object.
Call the Request a payment or payout endpoint. In the request body, provide the following:
source– The source of payment.amountcurrencydescriptionprocessing_channel_idamount_allocations.id– The sub-entity ID to link the payment to the sub-entityamount_allocations.amount– The amount to be credited to your sub-entity's currency account, in minor currency unit.amount_allocations.commission.amount– If applicable, the fixed mark-up in minor currency unitsamount_allocation.commission.percentage– If applicable, the variable mark-up
In the following example, the request charges a fixed mark-up of 2 USD:
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.
post
https://{prefix}.api.checkout.com/payments