BIS Innovation Hub
Nexus - Short ReportAbout the BIS Innovation Hub
  • Introduction
    • Nexus Overview
    • How to use this site
    • Overview Report
    • Terminology
  • Payment Setup
    • Key Points
    • Scope of Nexus payments
    • Steps 1-2: Country, Currency & Amount
    • Steps 3-6: Exchange Rates
    • Steps 7-9: Addressing, Proxy Resolution & Confirmation of Payee
    • Steps 10-11: Sanctions screening
    • Step 12: Ask the Sender for approval
    • Step 13-16: Set up and send the payment instruction
    • Step 17: Accept the confirmation and notify Sender
  • Addressing & Proxy Resolution
    • Key Points
    • Overview of Payment Addressing in Nexus
      • Addressing via Proxies (Aliases)
      • Addressing via Account Details
    • Address Types & Inputs
      • Address Types
      • Address Inputs
      • Financial Institution Identification
      • List of PSPs
      • Examples
    • Proxy & Account Resolution Process
      • Step 1: Sender inputs proxy or account details
      • Step 2: Proxy Resolution Messaging Sequence
      • Step 3: Account Resolution Messaging Sequence
      • Step 4: Source PSP processes the results
      • Masking of Display Names
    • Role of the Proxy Directory Operator (PDO)
      • Obligations on the Proxy Directory Operator
      • Obligations of PSPs using the Proxy Directory
      • Onboarding a Proxy Directory Operator onto Nexus
  • FX Provision
    • Key Points
    • Role of the FX Provider
    • How Third-Party FX provision works in Nexus
    • Joining Nexus as a third-party FXP
    • Accessing Instant Payment Systems
    • Onboarding PSPs
    • Obligations & Compliance
    • Revenue model for FXPs
    • Rates from Third-Party FX Providers
      • Improving rates for larger transactions
      • Improving rates for specific PSPs
    • Quotes
    • Managing Liquidity
  • Payment Processing
    • Key Points
    • Accounts & Relationships
    • Maximum value of a Nexus payment
    • Payment Flow (Happy Path)
      • Detailed Flow in Source Country (Sending)
      • Detailed Flow in Destination Country (Receiving)
      • Booking flow for Source PSPs
      • Notifying FXPs of completed payments
    • Validations, Duplicates & Fraud
    • Time critical vs non-time critical payments
    • Special Scenarios
    • Payment setup for PSPs who provide their own FX
    • Unsuccessful Payments (Exceptions)
      • Rejects
      • Recall Requests
      • Returns
      • Investigation & Enquiry
      • Disputes
      • Reconciliation reports
    • Fees
    • Role and responsibilities of the Instant Payment System Operator (IPSO)
    • Ensuring settlement certainty
    • Annex: 4-step vs 5-step Processes in Domestic Clearing and Settlement
    • Annex: Sponsoring PSPs and Sponsored Entities
  • Settlement Access Provision
    • Key Points
    • Role of the Settlement Access Provider (SAP)
    • Joining Nexus as an SAP
    • SAP onboarding of FXPs (or foreign PSPs)
    • Costs and Revenue for SAPs
    • Obligations on the SAP
    • Processing payments as an SAP
      • Payment Process for the Source SAP
      • Payment Process for the Destination SAP
      • How the Destination IPS initiates the payment via the Destination SAP
    • Managing Liquidity as an SAP
  • Messaging & Translation
    • Key Points
    • General Usage of ISO 20022
      • Adherence to CPMI Harmonised ISO 20022 Data Requirements
    • Compatibility with Instant Payments Plus (IP+)
    • Message transformation by Nexus
    • Specific Message Elements
    • Purpose Codes
    • Message Guidelines (Excel)
    • MESSAGE acmt.023 Identification Verification Request
    • MESSAGE acmt.024 Identification Verification Report
    • MESSAGE: pacs.008 FI to FI Customer Credit Transfer
      • pacs.008 Differences from CPMI Harmonisation Requirements
    • MESSAGE pacs.002 Payment Status Report
      • pacs.002 Differences from CPMI/CBPR+ Guidelines
    • MESSAGE: pacs.004 Payment Return (Not yet supported)
    • MESSAGE: camt.054 Bank to Customer Debit Credit Notification
    • Translation To/From Domestic Message Formats
    • Translating To/From ISO 20022 Codes
  • APIs
    • Overview
    • Countries
    • Currencies
    • Address Types and Inputs
    • Financial Institutions
    • Fees and Amounts
    • Intermediary Agents (SAPs)
    • Quotes
    • ISO 20022 Messages
  • About
    • Contact the Nexus Team
  • LEGAL
    • Terms and Conditions of Use
    • Privacy Notice
    • Cookies Notice
Powered by GitBook
On this page
  • Intermediary Agents
  • Exchange Rate
  • Amounts
  • Charges Information
  • Remittance Information
  • FX Quote ID
  • Message Transformation by Nexus
Export as PDF
  1. Messaging & Translation

MESSAGE: pacs.008 FI to FI Customer Credit Transfer

PreviousMESSAGE acmt.024 Identification Verification ReportNextpacs.008 Differences from CPMI Harmonisation Requirements

Last updated 5 months ago

The ISO 20022 pacs.008 message is used in Nexus as the payment instruction.

For further detail on each element in the pacs.008, please refer to the Message Guidelines (Excel).

Intermediary Agents

The Intermediary Agent elements of the pacs.008 are used define the Settlement Account Providers (SAPs) at which an FX Provider holds their funds. Payments flow from the Source PSP to the Source SAP, and then from the Destination SAP to the Destination PSP.

Source PSPs must use the API operation GET /quotes/{quoteId}/intermediary-agents to retrieve details of the intermediary agents, and then copy this information into the pacs.008. (The information may alternatively be included in the response to the original GET /quotes request.)

Exchange Rate

The exchange rate is recorded in the element:

… > Credit Transfer Transaction Information > Exchange Rate

This is the exchange rate that the FXP charges to the Source PSP. It is applied to Interbank Settlement Amount in the Source Currency, to determine what should be debited from the Destination SAP and transferred to the Destination PSP in the destination currency.

Note that this exchange rate is not the same as the effective exchange rate that is shown to the Sender, which is calculated by dividing the amount credited to the Recipient by the amount debited from the Sender.

The Nexus project team have submitted a change request to the ISO 20022 Standards Evaluation Group proposing a better way to track FX Providers and FX-related information (Change Request 1379 at ). If this is accepted and implemented in 2025, these documents will be updated with the new guidelines.

Amounts

  • The information about amounts included in the Nexus payment elements (in bold) as follows:

    • Instructed Amount = the exact amount debited from the Sender's account by the Source PSP, denominated in the Source Currency (the Debtor Account Amount).

    • Interbank Settlement Amount (in Source Currency) = the amount transferred from the Source PSP to the Source SAP. This is the Instructed Amount minus the Source PSP (Deducted) Fee. (See Fees.)

    • Interbank Settlement Amount (in Destination Currency) = the amount transferred from the Destination SAP to the Destination PSP. This is calculated by Nexus before the payment is sent to the Destination IPS. This is the Interbank Settlement Amount in the Source Currency multiplied by the Exchange Rate applicable to the transaction (based on the quote received from the FX Provider)

    • The amount credited to the Recipient is calculated by taking the Interbank Settlement Amount (in Destination Currency) and deducting the Destination PSP Deducted Fee, which is recorded in ChargesInformation/Amount (see below). Nexus calculates and provides the applicable Destination PSP fee in the response to the GET /quotes/ API (or the GET /creditor-agent-fee API - see Fees for further information.

Charges Information

Fees deducted by the Source PSP and Destination PSP must be recorded in the Charges section of the pacs.008 payment instruction; see Fees for further details. (The complete fee model and the requirements are detailed in the Nexus Scheme Rulebook.)

  • The Source PSP may charge a Deducted Fee by making a deduction from the amount debited from the Sender.

    • The Source PSP Deducted Fee is by definition the difference between Instructed Amount and Interbank Settlement Amount.

  • The Destination PSP must charge a Deducted Fee before crediting the Recipient.

    • The Destination PSP is determined according to a formula set by the Nexus Scheme, and is calculated by Nexus and shared with the Source PSP when they call the GET /quotes API operation (or a separate GET /creditor-agent-fee in the case that the Source PSP is also the FX Provider.

Both of these fees must be recorded (by the Source PSP) in the pacs.008 payment instruction as follows:

  • FI To FI Customer Credit Transfer > Credit Transfer Transaction Information >

    • Charge Bearer = SHAR

    • Charges Information [1]

      • Agent = Source PSP

      • Amount = Source PSP Deducted Fee

        • (Ccy = Source Currency)

    • Charges Information [2]

      • Agent = Destination PSP

      • Agent = Destination PSP Deducted Fee

        • (Ccy = Destination Currency)

If the Source PSP chooses not to charge the Source PSP Deducted Fee, it should still include the Charges Amount information with the amount set to zero.

Remittance Information

Nexus message guidelines permit the use of both the structured and unstructured remittance elements. The remittance elements cater for 140 characters of unstructured data, or structured remittance data. Nexus forwards the remittance elements unaltered.

The Structured Remittance element enables automated reconciliation by the Recipient between receivables and payments. It is recommended that the Recipient adopts the ISO 11649 Standard for a ‘structured creditor reference to the remittance information’ as the preferred remittance data convention for identifying payment referring to a single invoice.

The remittance data supplied by the Sender in the Nexus transaction must be forwarded in full and without alteration by the Source PSP, the SAPs involved and the IPSOs, to the Destination PSP.

When the Sender provides a Structured Creditor Reference, it is recommended that the Source PSP checks the correctness of the Structured Creditor Reference at the point of capture by the Sender.

For the Additional Remittance Information element, note that one of the three possible occurrences in the message is reserved for the Nexus FX Quote Id (see next section).

The Destination PSP must also deliver received remittance data in full and without alteration to the Creditor.

FX Quote ID

The Quote Id is provided by the response to the GET /quotes API operation. The quote ID is a Universally Unique Identifier (UUID).

The Quote ID retrieved by the Source PSP during the payment setup phase must be included in the pacs.008 payment instruction submitted to Nexus. The structured remittance element must contain the full Quote ID in the additional remittance information element.

Specifically, the Quote ID must be provided in the Additional Remittance Information element in the Structured section of the Remittance information, with the added prefix “NexusFXQuoteId" following by a colon.

<RmtInf>
    <Strd>
        <AddtlRmtInf>
NexusQuoteId:40fe970a-2f78-42a8-95a4-d09fa5f3b57f
        </AddtlRmtInf>
    </Strd>
</RmtInf>

The presence of the Quote ID is validated by Nexus and is used by Nexus to validate the exchange rate applied to the payment.

If no Quote ID is present, Nexus will validate that the Source PSP “owns” or has right to make payments from the Destination SAP, as defined in the Intermediary Agent 2 block.)

Up to three recurrences of the Additional Remittance Information element are allowed in a Nexus message. Two recurrences are free to use for other purposes.

Message Transformation by Nexus

Nexus must transform certain values in the pacs.008 before it is sent to the Destination Country:

  • Clearing System – updated from the Source IPS to the Destination IPS

  • Interbank Settlement Amount – converted from the source currency amount to the Destination Currency Amount, at the exchange rate defined in the message (and validated against the original FX Quote ID)

Nexus also updates the position of the following parties in the pacs.008 to create an instruction that can be processed by the Destination IPS:

Element in pacs.008 message

Party defined in Source Leg

Party defined in Destination Leg

Debtor

The Sender (account holder at the Source PSP)

No change

Debtor Agent

Source PSP

No change

Creditor

The Recipient (account holder at the Destination PSP)

No change

Creditor Agent

Destination PSP

No change

Instructing Agent

Source PSP

Change: Destination SAP

Instructed Agent

Source SAP

Change: Destination PSP

Intermediary Agent 1

Source SAP

No change

Intermediary Agent 1 Account

FX Provider’s Account at Source SAP

No change

Intermediary Agent 2

Destination SAP

No change

Intermediary Agent 2 Account

FX Provider’s Account at Destination SAP

No change

Previous Instructing Agent 1

Not used

Change: Source SAP

Previous Instructing Agent 1 Account

Not used

Change: FX Provider’s Account at Source SAP

Security techniques are used to enable the Destination IPS to verify that the message was only updated by Nexus and has not been tampered with.

The above solution is a compromise given limitations of the current ISO 20022 pacs.008 message structure. The Nexus project team have submitted a change request to the ISO 20022 Standards Evaluation Group proposing a better way to track FX Providers and FX-related information - see Change Request 1379 at

ISO20022.org
ISO20022.org