Confirmation of Payee
Confirmation of Payee (CoP) matches the account details youโve entered, with the details held by the recipientโs bank, when youโre sending money to a business or person using their BSB and account number. Confirmation of Payee (CoP) can help verify the payee and protect you from scams and mistaken payments.
The current version of CoP supports the โVerify Address Bookโ use case. Verification and update of the payee name for an existing address book entry, where the user is not changing the account number. For example:
- Verify the payee every 6 months
- User requested 'refresh' of a single address book entry
- One click bulk 'Verify Contacts' from the address book
What does Confirmation of Payee do?
Expose the confirmed data lookup services through a new API endpoint, and extensions to existing financial endpoints to utilise these services.
Monoova API Authentication
Authentication for the CoP API will be handled in Auth0, and API access will be based on a bearer token. The Bearer token can be retrieved using the token API Monoova API Documentation by passing the username as mAccount and the latest API Key as password in the header. The access token expires after 3600 seconds (60 minutes), at which point the customerโs application should generate a new one.
Confirmation of Payee match statuses
When a Confirmation of Payee check has been carried out, customers will see one of the following outcomes:
- Match โ the information entered matches the record of the recipient account.
- Close match โ the information is close, for example, entering "Paper Pen Co" instead of "Paper & Pen Company".
- No match โ the information entered does not match the data against the account youโre sending funds to.
- Error โ the CoP service was unable to confirm account details.
- Account closed โ the account you are attempting to send a payment to is closed.
For joint accounts, only one name needs to be supplied to get a match or close-match result, and names that include apostrophes or hyphens will match both with and without punctuation marks included.
๏ปฟ
CX result code
Code | Name | Description |
|---|---|---|
TICK | Green tick (โ) icon | Confirmed data match |
EXCM | Orange exclamation (!) icon | Close match, weak match or not enough info |
CROS | Red cross (x) icon | No match |
DASH | Orange dash (-) icon | Opt-out, account not found, account closed or generic errors |
API result code
Result code | Name | Description |
|---|---|---|
MTCH | Match Confirmed | The account name matches the account in confirmed data. |
CMTC | Close Match Confirmed | This is a close or very probable match in confirmed data. |
NMTC | No Match Confirmed | The account name entered does not match the account in the confirmed data. |
NFND | Account Not Found | Account not found in the confirmed data holder system |
CLSD | Account Closed | Account closed in the confirmed data holder system |
ERRR | Error or Opt-out | Opt-out and Generic errors |
Request purpose code
Purpose Code | Name | Description |
|---|---|---|
PAYE | Payee | CoP lookup for a payee account. For example:
|
VADR | Verify Address Book | Verify and update a payee name for an existing address book entry when the user is not changing the account number. For example:
|
PYMT | Payments | The system looks up the existing payee account number when processing payment, aiming to reduce errors or fraud. For example:
|
MAND | Mandate Management | Account looked up during PayTo payment agreement/mandate processing or direct debit setup. For example:
|
PIRQ | Payment Initiation Request | Payer or Payee account is looked up before triggering the PayTo payment initiation. |
INVN | Investigation | Staff manually perform a CoP lookup for an investigation. |
๏ปฟ
Test data for Sandbox
To simulate different Confirmation of Payee (CoP) responses in the Sandbox environment, you can trigger specific outcome codes by providing the test bank account data listed below.
Any requests that do not explicitly match the custom triggers below will return the default successful match response.
Scenario | BSB | Account Number | Account Name | Single/joint Account | CX Result Icon Code | CX Result Code |
|---|---|---|---|---|---|---|
Swift match_Result= MTCH | 012408 | Any 9-digit number | Macey Jones | Joint account | TICK | MTCH |
Swift match_Result= MTCH | 012408 | Any 9-digit number | Oz Mining Rocks Pty | ๏ปฟ | TICK | MTCH |
Swift match_Result= CMTC | 012408 | Any 9-digit number | Claudia Mcbride | Single account holder | EXCM | CMTC |
Swift match_Result= NMTC | 012408 | Any 9-digit number | Nancy Nolan | Single account holder | CROS | NMTC |
Swift match_Result= NMTC | 012408 | Any 9-digit number | Westley Ning | ๏ปฟ | CROS | NMTC |
Swift match_Result= CMTC | 012408 | Any 9-digit number | Blue Horizon Landscaping t/a Blue Horizon | ๏ปฟ | EXCM | CMTC |
Swift match_Result= MTCH and matched names exceed 269 characters and indication of order of preference | 012408 | Any 9-digit number | Hubert Blaine Wolfsterneschlegelsteinhausenbergerdorff | Joint Account | EXCM | CMTC |
Opt out | 012408 | Any 9-digit number | Trout Cherry | ๏ปฟ | DASH | ERRR |
Swift match_Result= MTCH and ODH result_code= MTCH | 012408 | Any 9-digit number | Macey Jones | Joint Account | TICK | MTCH |
Account Closed | '012408 | Any 9-digit number | Clara Moss | ๏ปฟ | DASH | CLSD |
Account not found | '012408 | Any 9-digit number | Matthew Knight | ๏ปฟ | DASH | NFND |
CoP Not performed | '012408 | Any 9-digit number | Knox Berry | ๏ปฟ | DASH | ERRR |
DataHolderRefusal | '012408 | Any 9-digit number | Strawberry Wilson | ๏ปฟ | DASH | ERRR |
TooManyTransactions | '012408 | Any 9-digit number | Jack Elizabeth | ๏ปฟ | DASH | ERRR |
Timeout | '012408 | Any 9-digit number | Naomi Timber | ๏ปฟ | DASH | ERRR |
MessageUndeliverable | '012408 | Any 9-digit number | Adam Williams | ๏ปฟ | DASH | ERRR |
DataHolderServiceError | '012408 | Any 9-digit number | Henry Ryan | ๏ปฟ | DASH | ERRR |
DEFAULT scenario Swift match_Result= MTCH | 012408 | Any 9-digit number | Any other name except those listed above | ๏ปฟ | TICK | MTCH |