Post multi-leg payment

Allow you 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 20. 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, refer to the Multi-leg payments guide. 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.
  • Processing sequence: Debit legs are always processed before credit legs. Within each group, the sequence is not guaranteed, and the order of execution among debits or among credits is non-deterministic.

Each leg generates the following events:

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length between 1 and 43
^[a-zA-Z0-9-]+$

A unique multileg payment identifier provided by the client. If an existing multileg_id already exists in the system, the API returns a 409 error.

This field is:

  • Unique within the Organization.
  • Immutable — It can't be updated.
  • Not recyclable — You can't reuse a multileg_id.
metadata
object

Key-value pairs containing data intended for storage in the Pismo system.

Note: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to Get started with Pismo APIs.

debits
array of objects
debits
credits
array of objects
credits
Responses

403

The request has been lost

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json