Nexus - Short Report About the BIS Innovation Hub

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).

PreviousQuotes NextContact the Nexus Team

Last updated 2 months ago

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.

post

/iso20022/acmt023

Query parameters

acmt024Endpointstring · urirequired

An API URL exposed by the Source PSP where the acmt.024 response (which contains underlying account details) should be sent.

Body

string

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

Responses

application/xml

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'http://localhost:3000/iso20022/acmt023?acmt024Endpoint=https%3A%2F%2Fexample.com' \
  --header 'Content-Type: application/xml' \
  --data '"[Full XML of the acmt.023 request]"'

200

<?xml version="1.0"?>
<object>[Full XML of the acmt.024 response]</object>

Successful 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.