MESSAGE: pacs.008 FI to FI Customer Credit Transfer
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 ISO20022.org). 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 theExchange 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 theGET /quotes/
API (or theGET /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 separateGET /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.
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
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.
Last updated