Enable users to submit a payment with multiple legs to the platform. The payments are processed asynchronously and must contain at least two legs, but no more than twenty.

The payload contains debits and credits lists. These lists include legs that follow the requirements of credit and debit objects in the Post payment endpoint.

For information about multi-leg payments, see the Post multi-leg payment section in Payment overview.

NOTES:

• To find the correct reason IDs, refer to the List account status reasons endpoint.
• This endpoint does not support forced transfers from an earmark balance.
• For error handling, see Error handling mechanism in Payment overview.

Each leg generates the following events:

• Platform authorization created
• Account balance changed
• Account balance changed (Availables)
• Accounting entry created
• If flex controls are configured, a Flex control evaluated event is triggered.

Additionally, the following events are generated for multi-leg payments:

• Multi-leg payment lifecycle created
• Multi-leg payment lifecycle status changed

See Data and reporting for more information about events and setting up event notifications.