ISO 20022 Messages

ISO 20022 messages are submitted to Nexus via asynchronous API.

The ISO 20022 XML message itself will be included in full in the message body.

The requestor (Source PSP) will also define an endpoint to which Nexus should send the resulting response (ie when submitting acmt.023, the Source PSP must also define the acmt024Endpoint to which Nexus should send the acmt.024 response).

Submit ISO 20022 acmt.023 message (Proxy or Account Resolution Request)

This endpoint accepts an ISO 20022 acmt.023 message in XML format. The message must be prepared according to the Nexus Message Usage Guidelines.

POSThttp://localhost:3000/iso20022/acmt023

Query parameters

Body

application/xml

string

Example: "[Full XML of the acmt.023 request]"

Response

200

Successful response

Body

application/xml

string

Example: "[Full XML of the acmt.024 response]"

Request

JavaScriptCurlPython

const response = await fetch('http://localhost:3000/iso20022/acmt023?acmt024Endpoint=https%3A%2F%2Fexample.com', {
    method: 'POST',
    headers: {
      "Content-Type": "application/xml"
    },
    body: JSON.stringify("[Full XML of the acmt.023 request]"),
});
const data = await response.json();

Response

200

[Full XML of the acmt.024 response]

Submit ISO 20022 pacs.008 message (FI to FI Customer Credit Transfer - the core Nexus payment instruction)

This endpoint accepts an ISO 20022 pacs.008 message in XML format. The message must be prepared according to the Nexus Message Usage Guidelines.

POSThttp://localhost:3000/iso20022/pacs008

Query parameters

Body

application/xml

string

Example: "[Full XML of the pacs.008 request]"

Response

200

Successful response

Body

application/xml

string

Example: "[Full XML of the pacs.002 response]"

Request

JavaScriptCurlPython

const response = await fetch('http://localhost:3000/iso20022/pacs008?pacs002Endpoint=https%3A%2F%2Fexample.com', {
    method: 'POST',
    headers: {
      "Content-Type": "application/xml"
    },
    body: JSON.stringify("[Full XML of the pacs.008 request]"),
});
const data = await response.json();

Response

200

[Full XML of the pacs.002 response]