Address Types

In Nexus, each address type is defined by an ISO 20022 code:

• Account details will be described with the code IBAN (for IBAN) or ACCT (for Account Identifications).

• If ACCT is used, it will be necessary to also collect a Financial Institution Identification alongside the Account Identification. The Address Inputs API informs PSPs what information that needs to be collected.

• Proxies are defined by the ISO 20022 ExternalProxyAccountType1Code, taken from the ISO 20022 External Code Set

The table below lists the possible address type codes in Nexus. The most commonly accepted address types are bolded.

Even IPS that use ISO 20022 domestically often use proprietary codes to describe proxies, for example, using "MSISDN" rather than the ISO 20022 "MBNO". There are particular translation challenges to consider around the use of proxy code - please see Translating To/From ISO 20022 Codes for further detail.

Table: Address types & codes

CODE (ISO 20022)	MEANING	TYPE	NOTES
IBAN	International Bank Account Number	Account Identification	Typically defines country, PSP and account. (In some countries, the BIC or Clearing System Member Id is not included in the IBAN, so separate enrichment tables must be used to map a subset of the IBAN to the relevant FI Id.)
ACCT	Account Identification (to be used in conjunction with a Financial Institution Identification)	Account Identification	Must be used in conjunction with a Financial Institution Identification (see table below)
BIID	Biller Subscriber Identification	Proxy Id
CINC	Certificate of Incorporation Number	Proxy Id	Company registration number
COTX	Corporate Tax Identification	Proxy Id
COID	Country Authority Identification	Proxy Id
CUST	Customer identification Number	Proxy Id
DNAM	Domain Name (Internet)	Proxy Id
DRLC	Driver License Number	Proxy Id
EIDN	Electronic Identification	Proxy Id
EMAL	Email address	Proxy Id
EWAL	E-Wallet identification	Proxy Id
PVTX	Individual tax identification	Proxy Id
LEIC	Legal Entity Identifier Code	Proxy Id
MBNO	Mobile phone number	Proxy Id	Most commonly accepted proxy type
NIDN	National identification number	Proxy Id
CCPT	Passport number	Proxy Id
SHID	Scheme identification Number	Proxy Id	Often used for virtual payment addresses
SOSE	Social Security Number	Proxy Id
TELE	Telephone Number (land line)	Proxy Id
UBIL	Utilities Subscription Identification	Proxy Id
VIPN	Vehicle Identification Plate Number	Proxy Id
TOKN	Virtual payment addresses (treated as a “token”)	Proxy Id