Account Check

Real-time account checks that safeguard payments from fraud, mistakes, and misdirected payments, giving your business confidence every time

📘

The Account Check Service is currently in 'early release' stage. The API and guides may change.

Purpose

This guide serves as a starting point to provide you with an overview of Azupay's Account Check service and Confirmation of Payee.

Introduction

Azupay's Account Check Service (ACS) enables real-time matching of customer-provided details, led by your workflow and powered by Confirmation of Payee (CoP) and PayID Name Check so businesses can reduce mistakes, minimize rework, and make more confident payment decisions.

📘

Currently, CoP is available via the Account Check API endpoint. PayID Name Check may be migrated from the PayID enquiry endpoint in future

Confirmation of Payee (CoP)

Confirmation of Payee provides a layer of protection for payments to a BSB and account number by matching the account details provided with the account details held by the recipient's bank and displaying a match outcome. It's a new layer of protection for Australian businesses when they're making payments to a BSB and account number.

Confirmation of Payee can help safeguard businesses from fraud, scams, and mistaken payments, and help protect their money. It provides confidence that the details provided match the details held by the recipient's bank.

Importance

  • Growing scam and fraud risk: Scams and fraudulent activity continue to rise, increasing the need for stronger protection when making payments to a BSB and account number.
  • Payment redirection threats: False billing and payment-redirection scams can divert funds to the wrong account, often without being noticed until it's too late.
  • First-time payments are higher risk: New or one-off payments are especially vulnerable because there is less confidence that the account details belong to the intended recipient.
  • Increasing regulatory focus: Regulators are pushing for stronger "know your payee" standards, placing more emphasis on verifying account details before a payment is made.

API Implementation

See API Spec here - https://developer.azupay.com.au/v0/reference/post_accountcheck#/

📘

Contact your Account Manager to enable Account Check API permissions.

Required Parameters

  • accountCheckId: Unique lookup identifier
  • bsb: Target account BSB
  • accountNumber: Target account number
  • accountName: Expected account holder name
  • purposeCode: Lookup purpose:
    • PYMT: Payment processing (existing customer verification)
    • PAYE: Customer onboarding or change in details
    • MAN: PayTo/direct debit setup
    • PIRQ: Pre-PayTo Payment Initiation lookup
  • additionalDetails:
    • endUserId: Unique customer identifier
    • endUserSessionId: User session identifier

Response Format

Standard responses include:

  • accountCheckResultCode
  • accountCheckResult

Below is a list of possible of values for accountCheckResultCode

accountCheckResultCodeaccountCheckResult
MTCHMatch
CMTCClose Match
NMTCNo Match
NFNDAccount Not Found
CLSDAccount Closed
ERRRError

When the accountCheckResult is ERRR the API response will also include the following:

  • errorReasonCode
  • errorReasonDescription

Below is a list of possible of values for errorReasonCode

accountCheckErrorReasonCodeaccountCheckErrorReasonDescriptionDescription
BSBNBSB not foundBSB not found. This could be due to an invalid BSB
SRVCService ErrorRequest cannot be processed
TECHToo many requests by the user or sessionThe user has reached their CoP limit for the day

When you receive an error, we will also provide with advice if you should retry the lookup. If retryAdvice is true then retry the CoP lookup at a later stage. If If retryAdvice is false do not attempt another CoP lookup.

Test Data

To simulate different accountCheckResults and error scenarios use the test data below in the Staging environment.

Note: Individual accounts are personal accounts and Non-Individual account are business accounts

Scenario

Test Data

accountCheckResult

Match: Individual account

Macey Jones

Match

Close Match: Individual account

Claudia Mcbrid

Close Match

No Match: Individual account

Westley Ning

No Match

Account not found: Individual account

Matthew Knight

Account Not Found

Account closed: Individual account

Clara Moss

Account Closed

Match: Non Individual account

Oz Mining Rocks Pty

Match

Close Match: Non Individual account

CYRONICS

Close Match

No Match: Non Individual account

Private Insurance Limited

No Match

Service Error

John Smith

Error

Technical Error,
Too many requests by the user or session

Henry Ryan
BSB: 888777
Account: 11112222

Error

BSB Not found

Name: Thesis BSB : 223457 Account No : Any

Error

CX Guidelines

Customer Experience (CX) guidelines help ensure Azupay's Account Check service is presented consistently, clearly, and confidently to your end users. Well-designed journeys make it easy for customers and internal users to understand what's happening, what the result means, and what action to take next, so you get the full risk-reduction and operational benefits of Confirmation of Payee without adding friction or confusion.

Icon and Messaging

accountCheckResultIconMessage
MatchThe account details you entered match the bank records of the intended recipient.
Close MatchThe account details you entered closely match the bank records of the intended recipient. Please double-check before you continue.
No MatchThe account details you entered do not match the bank records of the intended recipient. Please double-check account details with your intended recipient.
Account Not FoundWe couldn't find an account with these details. Please check the BSB and account number.
Account ClosedThis account is no longer active. Please use a different bank account.
ErrorThe service could not confirm the account details you entered match. Please double-check account details with your intended recipient.