Process sub-entity payments
Beta
Last updated: March 25, 2026
After your sub-entity has passed onboarding checks and has payment capabilities enabled, you can start processing payments on their behalf.
The following payment methods are supported:
- American Express
- Discover
- Visa
- Mastercard
- ACH Direct Debit
- Apple Pay
- Cartes Bancaires
- Google Pay
- PINless Debit
If you want to charge a commission from the sub-entity for facilitating the transaction on your platform, there are three ways to apply it:
- Fixed commission amount in minor currency units
- Variable commission, as a percentage of the payment
- Compound commission which is a fixed commission, with an additional variable commission as a percentage of the payment amount
If you do not need to use Checkout.com to charge a commission, then omit the commission from your 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 with 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– Fixed amount of commission in minor currency unit, if applicableamount_allocation.commission.percentage– The percentage of commission, if applicable
In the following example, the request charges a fixed commission 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
Incremental authorization is not supported by the amount_allocations object. While it's possible to extend a split payment's authorization validity period, any increase to the amount is ignored when the payment is captured.