# Steps 7-9: Addressing, Proxy Resolution & Confirmation of Payee

{% hint style="info" %}
See [Addressing & Proxy Resolution](/addressing-and-proxy-resolution/key-points.md) for further detail on how addressing is managed in Nexus.
{% endhint %}

### 7.1 App generates the addressing form <a href="#toc116457918" id="toc116457918"></a>

Next the Source PSP should provide the Sender with a form that allows them to select from the addressing formats available in the Destination Country and enter the proxy or PSP account details.

The form should first list the available proxy types, since these are usually easier for the Sender to input, followed by IBAN (if accepted), followed by any domestic account formats.

This form can be generated dynamically using the response to the `GET /countries/{countryCode}/address-types-and-inputs`. This API operation will return the list of proxy formats available in the destination country; this data can be used by the app to dynamically generate the form.

{% hint style="info" %}
The `address-types-and-inputs` API combines the results of two API operations into one response:

* `GET /countries/{countryCode}/address-types`
* `GET /address-types/{addressTypeId}/inputs`

A PSP could also choose to call the two APIs above independently to avoid retrieving data for address types that may not be selected by the Sender.
{% endhint %}

### 7.2 Sender selects an address type <a href="#toc116457919" id="toc116457919"></a>

The Source PSP should present the Sender the list of available address types, as shown below. The Sender can select the appropriate address type based on what information the Recipient has given them.

<figure><img src="/files/hPsIneeFECKvrf2Jou9s" alt=""><figcaption><p>The Sender will select the type of proxy they were given, or local account number or IBAN, and then enter the details.</p></figcaption></figure>

### 7.3 Sender enters addressing details <a href="#toc116457920" id="toc116457920"></a>

Each `addressType` is made up of one or more corresponding `input`s. For example, an IBAN only requires one input (the IBAN text itself) whereas a proxy will require both the proxy ID value itself (eg a mobile phone number) and the proxy type code (eg `MNBO`).

On the next screen, the Sender should be asked to enter the specific addressing details, depending on the option they selected before.

## Step 8: PSP sends proxy or account details to Nexus <a href="#toc116457921" id="toc116457921"></a>

**The Source PSP should now send the proxy or account details provided by the Sender as an ISO 20022** [**acmt.023**](/messaging-and-translation/message-acmt.023-identification-verification-request.md) **message.** This triggers the following steps:

1. If a proxy is provided, **Nexus will send the proxy to the proxy lookup service** in the Destination Country. (The proxy lookup service will map the proxy to a financial institution identifier (eg BIC) and account number, or return an error if the proxy is not registered to an account.)
2. Nexus will follow the steps outlined in [Proxy & Account Resolution Process](/addressing-and-proxy-resolution/proxy-and-account-resolution-process.md) to contact the relevant proxy directory and/or Destination PSP.
3. Nexus will respond to the Source PSP with:
   1. the financial institution identifier
   2. the account number
   3. the Recipient’s full name, visible only to the Source PSP
   4. the Recipient's display name, which can be shown to the Sender
   5. any further personal data that is provided by the Proxy Directory or Destination PSP
4. The current proxy lookup service via Nexus enables the Sender to provide a proxy, which will be resolved into account details, which are presented to the Sender for verification. Nexus will also support Verification of Payee, by allowing the Sender to input the details. This will be designed in a future phase.

## Step 9: Ask Sender to Confirm Payee <a href="#toc116457922" id="toc116457922"></a>

**The Source PSP should now ask the Sender to confirm that they recognize the Recipient’s name before proceeding with the payment.** This "confirmation of payee" or "verification of payee") step allows the Sender to verify that the holder of the Destination Account is actually the person or business they intend to pay. This provides a check against fraud as well as giving the Sender greater confidence that they entered the proxy or account details correctly.

{% hint style="info" %}
This process works when a proxy is used to address a payment. In some countries, particularly in Europe, confirmation of payee works differently. First the Sender is asked to provide the expected name of the Recipient, which is compared by the Destination PSP to the actual name they have on file. The Sender is then informed whether the actual name is matches the expected name, or is a close match, or not a match at all. This approach to confirmation of payee will be added to a future version of Nexus.
{% endhint %}

<figure><img src="/files/CYbPazkwibSzElsXOw60" alt=""><figcaption></figcaption></figure>

In most cases, the response to the `acmt.023` proxy or account resolution request will include the Recipient’s real name or a partially masked display name. This information is retrieved from either the proxy directory or the Destination PSP.

The Source PSP should show this to the Sender and ask them to confirm that this is the name they are expecting to see.

{% hint style="warning" %}
In some cases, the real name AND display name fields will both be blank. This can occur when:

The Destination PSP does not support the `acmt.023/acmt.024` process, **AND** either:

* The proxy lookup service itself does not store or provide the account holder’s name or nickname **OR**
* The Sender provided a local account number (so there was no proxy lookup)

In this situation, **there is no way for the Sender to confirm the identity of the Recipient** and this confirmation-of-payee step can be skipped. In such cases, the Sender must send the payment “blind” to the real identity of the account holder. **This may increase the risk of them making a payment to a fraudulent or mistaken account.**

This is one reason why it is always preferable to list the proxy options first in the addressing form, rather than IBAN or a local account number; most proxy schemes will return a name or nickname but it is possible that not all PSPs will support the account resolution process.)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexusglobalpayments.org/payment-setup/steps-7-9-addressing-proxy-resolution-and-confirmation-of-payee.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
