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
  • Use of purpose codes
  • Challenges with traditional approaches to purpose codes
  • Rules around use of purpose codes in Nexus
  • Carrying purpose codes in the pacs.008
Export as PDF
  1. Messaging & Translation

Purpose Codes

Use of purpose codes

Purpose Codes and Category Purpose Codes (P/CP codes) are used in some jurisdictions for AML/CFT, capital flow measures (exchange controls), balance-of-payments calculations or other regulatory reporting reasons. Payments to those jurisdictions that do not provide a P/CP code may be rejected or may require manual processing.

Challenges with traditional approaches to purpose codes

Typically each country uses their own domestic purpose code list, which is not harmonized between countries. This requires PSPs in each country to know the purpose code list of each other country, and to ask the Sender to select an appropriate code from the list before confirming the payment. In some cases, a Sender may have to select a code twice from two different lists (for the Source Country and Destination Country).

This approach is not suitable for Nexus payments. Instead, Nexus uses the harmonized ISO 20022 External Code Set codes for purpose and category purpose codes. This means that each PSP only needs to be able to map the domestic code list to the ISO 20022 code list, without having to know the domestic code list of every other country. (If the IPS uses translation then the IPS may do the mapping on the PSPs’ behalf.)

Rules around use of purpose codes in Nexus

  1. Nexus does not require the use of Purpose Codes or Category Purpose Codes (P/CP Codes).

    • This is in line with the CPMI Harmonized ISO 20022 requirements.

    • Nexus will not reject pacs.008 payment instructions where the P/CP elements are left empty or null, or where the entire element is missing from the message structure.

  2. However, some Nexus-member jurisdictions do require the use of P/CP codes.

    • Source PSPs should use P/CP codes when they are required in the Destination Country.

      • Source PSPs are able to establish whether the receiving country requires a P/CP code or not by reviewing the response to the GET /countries/ API.

    • In the jurisdictions that do require P/CP codes, Destination PSPs may reject payments that do not include a Purpose Code and/or Category Purpose Code (rather than manually requesting further information from the Source PSP).

Alternatively, a Destination PSP may choose to respond with an “Accepted without posting” (ACWP) status code, and follow up manually to get the correct purpose code from the Source PSP. This will delay the payment and add costs for both the Source and Destination PSPs, so should be avoided and is only allowed for non-time critical payments.

  1. A Source PSP may include P/CP codes even when they are not mandatory in the Destination Country

    • A Destination PSP in a jurisdiction that does not use P/CP codes must not reject a message that does include a P/CP code. (The Destination PSP may ignore the P/CP code.)

    • When in doubt, it is safer to provide a purpose code than to omit it.

  2. When a Nexus pacs.008 does include a P/CP code, it must only use a code from the ISO 20022 External code set.

    • The relevant code types are ExternalCategoryPurpose1Code and ExternalPurpose1Code. (See table below.)

    • PSPs must not use the Proprietary code element (… > Purpose > Proprietary or … > CategoryPurpose > Proprietary).

    • PSPs must not put proprietary (domestic) codes into the .. > CategoryPurpose > Code or ..Purpose > Code element

  3. The Category Purpose Code and the Purpose Code in the message are not used by Nexus in the processing logic and do not affect the payment process itself. However, a Destination PSP may consider the P/CP codes when deciding whether to accept a payment.

Carrying purpose codes in the pacs.008

The pacs.008 message format used by Nexus contains two elements to carry this information:

ELEMENT & PATH

EXTERNAL CODE SET

ISO 20022 DEFINITION

ISO 20022 OFFICIAL USAGE

Category Purpose Code (.. Category Purpose > Code)

ExternalCategory-Purpose1Code (44 values)

“Specifies the high-level purpose of the instruction based on a set of pre-defined categories.”

“This is used by the initiating party to provide information concerning the processing of the payment. It is likely to trigger special processing by any of the agents involved in the payment chain.”

Purpose Code (.. > Purpose > Code)

ExternalPurpose1Code (300+ values)

“Underlying reason for the payment transaction”

“Purpose is used by the end customers, that is initiating party, (ultimate) debtor, (ultimate) creditor to provide information concerning the nature of the payment. Purpose is a content element, which is not used for processing by any of the agents involved in the payment chain.

In principle, all purpose codes from the external code list are accepted, although some codes may not be relevant for Nexus use cases.

PreviousSpecific Message ElementsNextMessage Guidelines (Excel)

Last updated 8 months ago