BIS Innovation Hub - Nexus
Nexus - Short ReportAbout the BIS Innovation Hub
Search…
Nexus Overview
PARTICIPANTS
Participants in the Nexus Network
User Experience
User Needs of Senders and Recipients
User Needs for Other Participants
The User Journey for Nexus Payments
An End-To-End Payment Through Nexus
Overview of Payment Flow
Setup: Synchronizing Service Level Descriptions (SLDs)
Setup: FX Providers update their rates
Step 1: Retrieving the SLD for the Destination IPS
Step 2: Retrieving current FX quotes
Step 3: Account Validation
Step 4: Confirmation of Payee
Step 5: Sanctions Screening Pre-Approval
Step 6: Final Payment Instruction
IPS & Bank Functionality
IPS Service Level Descriptions
Addressing Payments
Reachability & Availability Checks
Account Validation
Confirmation of Payee
Sanctions Screening
Sanctions Screening
FX PROVIDERS & LIQUDITY PROVIDERS
FX Providers
Liquidity Providers
Roles vs Entities: Possible Configurations of FX Providers and Liquidity Providers
Providing FX Quotes
Ensuring a Competitive FX Market
Managing Liquidity
FX Provider Blacklists
RISK MANAGEMENT
Credit, FX and Liquidity Risk
Settlement Risk Due to Insolvency of a Participant
NEXUS GATEWAY & SCHEME
Nexus Gateway
Nexus Scheme
ANNEX: API & Message Definitions
API Structure Overview
ISO 20022 Terminology
SLD API
Quote API
Account API
Payee API
Sanctions Screening Pre-Approval API
Payment Instruction (Source Bank to Source IPS)
ANNEX: Recalls & Unhappy Flows
Terminology & Acronyms
Payment Recalls & Unhappy Flows
About
Contact the Nexus Team
Terms and Conditions of Use
Powered By GitBook
Payee API

Confirmation Of Payee (Source Bank to Nexus)

GET /v1/payee/

Request

Attribute
Type
Condition
Description
Destination Country ID
String
Mandatory
Two-letter country code for Destination Country
Destination Bank Identifier
String
Mandatory
Required for routing purposes
Destination Bank Account Number
String
Mandatory
Used for validation purposes
Destination Bank Account Holder Expected Name
String
Conditional
Expected Name to be matched if Comparison model is used

Response

Attribute
Type
Condition
Description
CoP Type
String
Mandatory
Model of CoP used in this result. Comparison, Nickname or RealName
CoP Match Status
String
Conditional
If Comparison model used, shows result: Full Match, Close Match, None
Destination Bank Account Holder Name
String
Conditional
Unmasked full name, for sanctions checking purposes, not to be disclosed to end-customer. Availability of this field may be dependent on local regulation.
Destination Bank Account Display Name
String
Conditional
Name to be displayed to the end-customer if Nickname or RealName model is used. May contain full official name, partially masked name or nickname.

Sub Process: Confirmation of Payee (Destination Nexus Gateway to Destination IPS / Destination Bank)

This step is triggered by Nexus as it responds to the Confirmation of Payee request above The Confirmation of Payee request will follow local standards, as configured by Nexus, as this is a request from the Nexus Gateway to the Destination IPS or Destination Bank. However, as a minimum, the Destination IPS or Destination Bank must return the following information to the Nexus Gateway:
Response – Minimum Fields
Field
Condition
CoP Match
Mandatory if Comparison Model used
Destination Bank Account Holder Name
Mandatory if Real Name is used
Destination Bank Account Display Name
Mandatory if Nickname is used or real name cannot be shown to end user due to privacy rules
ANNEX: API & Message Definitions - Previous
Account API
Next - ANNEX: API & Message Definitions
Sanctions Screening Pre-Approval API
Last modified 4mo ago
Copy link
Contents
Confirmation Of Payee (Source Bank to Nexus)
Sub Process: Confirmation of Payee (Destination Nexus Gateway to Destination IPS / Destination Bank)