Download Postman Collection
2026

Sections

Theme switcher

[3] Instruct Deal

Header Parameters

Content-Typestring Required

application/json

CMG-AccessTokenstring Required

{insert Client-level "access_code"}

Path Parameters

clientCodestring Required

A unique 6-digit client identifier for each client account.

Body Parameters

requestIdstring

Client-generated unique idempotency key for the request. For compatibility, it is recommended to provide a GUID value.

ordersarray

Details of the order

Show child attributes

paymentsarray

Beneficiary Payment Details

Show child attributes

settlementsarray

Beneficiary Settlement Details

Show child attributes

Response

200
Object
Instruct Deal

Response Attributes

contentobject

Show child attributes

errorsarray
linksarray

SELF LINKS

Show child attributes

200 Instruct Deal with Reg E
Object
Instruct Deal with Reg E

Response Attributes

contentobject

Show child attributes

errorsarray

SELF LINKS

linksarray

Show child attributes

400 Incorrect Beneficiary
Object
Incorrect Beneficiary

Response Attributes

contentobject
errorsarray

An array containing error objects, including error codes and the message

Show child attributes

linksarray

Show child attributes

Incorrect Settlement Account

Response Attributes

contentobject
errorsarray

Show child attributes

linksarray

Show child attributes

400 Deactivated MCA sent as Bene
Object

Response Attributes

errorsarray

Show child attributes

Response Attributes

errorsarray

Show child attributes

Was this section helpful?

What made this section unhelpful for you?

POST

/

Select
1

Response

Error Codes

400

Incorrect settlement account / incorrect 'deliveryMethod' Either the Client does not have the permission set to settle with this account type, or the account identifier provided in the request is incorrect.

400

Incorrect bene / incorrect 'deliveryMethod' Could be one of the following: The beneficiary identifier provided in the request is incorrect (the 'clientIntegrationId' or 'id'). The bene does not exist (so the 'id' or 'clientIntegrationId' you are using is invalid).

400

Invalid / already-instructed Order Number The order number has already been instructed, or it doesn't belong to your account.

400

Amount exceeds Spot balance The order does not contain the funds available to pay the beneficiary. A top-up is not possible.

Was this section helpful?

What made this section unhelpful for you?