Confirmation of Payee - Requester

Description of Confirmation of Payee Requester service.

Service description

This service verifies if the creditor's account number matches the associated name.

Request

TBU

Header

TBU

Body

Name	M/O	Description
AccountCategory	M	Defines if the verification is expecting a 'personal' or 'business' account
Identification	M	UK account number of the account to do a name verification on. BBAN (sort code + account number)
Name	M	The name string to be checked for a match.
SecondaryIdentification	O	Secondary reference information to identify the account. Can be any type of additional identification that is present with the account, e.g. a building society roll number

Response

Header

TBU

Body

Successful

{
  "OriginalMessageId": "...",
  "Data": {
    "Answer": "string",
    "Identification": "string",
    "ActualName": "string",
    "Name": [
      "string"
    ],
    "ReasonCode": "string",
    "Description": "string"
  },
  "Errors": null
}

Error

{
  "OriginalMessageId": "...",
  "Data": null,
  "Errors": [
    {
      "ErrorCode": "...",
      "ErrorMessage": "..."
    }
  ]
}

Reason code values

ReasonCode	Description
AC01	There is no account with the given account number.
ACNS	Account does not support Confirmation of Payee.
ANNM	String does not match the account name.
BAMM	String is a close match to the account name. The type of account is Business when Personal was indicated in the request.
BANM	String is a match to the account name, but the type of account is Business when Personal was indicated in the request.
CASS	Account has been switched to a different organisation.
IVCR	Invalid secondary customer reference data.
MBAM	String is a close match to the account name.
OPTO	Account opted out of Confirmation of Payee.
PAMM	String is a close match to the account name. The type of account is Personal when Business was indicated in the request.
PANM	String is a match to the account name, but the type of account is Personal when Business was indicated in the request.
SCNS	Organisation doesn't own the provided sort code.