Banked fires a webhook notification when a Confirmation of Payee (CoP) verification completes. This allows your system to react immediately to the verification result without polling the API.
This guide covers:
- CoP Webhook Event: Overview of the webhook event
- Payload Examples: Example payloads for each verification outcome
CoP Webhook Event
The following event is fired when a CoP verification completes:
| Event Type | Description |
|---|---|
payment_instrument_bank_account_verification_completed | Fired when a CoP verification completes, regardless of the outcome |
Always check details.verification.status and details.verification.result to determine the actual outcome.
New to Webhooks? Start with our Webhook Overview to understand how to set up and handle webhooks effectively.
Payload Examples
The same event type is used for all outcomes. Examples are provided below for each possible result.
Verification Completed: Match
{
"id": "3a7e0e66-3b15-496a-8948-458a0a50488e",
"type": "payment_instrument_bank_account_verification_completed",
"version": "v3",
"data_version": 1,
"data": {
"payment_instrument_id": "c3f87070-c2d8-4dbd-8943-7e280fc4c8fb",
"on_behalf_of": "customer",
"mode": "live",
"created_at": "2025-12-02T16:34:00.000000Z",
"updated_at": "2025-12-02T16:35:01.987654Z",
"status": "active",
"details": {
"instrument_type": "bank_account",
"currency": "AUD",
"account_owner_name": "Jane Smith",
"identifier": {
"identifier_type": "bsb_account",
"bsb": "123456",
"account_number": "12345678"
},
"verification": {
"status": "completed",
"result": "match",
"registered_account_name": "Jane Smith",
"verified_at": "2025-12-02T16:35:01.987654Z",
"method": "cop"
}
}
}
}
Verification Completed: Close Match
Note that registered_account_name differs slightly from the account_owner_name provided:
{
"id": "7095c887-b186-4f9a-8788-2128d4ab5303",
"type": "payment_instrument_bank_account_verification_completed",
"version": "v3",
"data_version": 1,
"data": {
"payment_instrument_id": "c3f87070-c2d8-4dbd-8943-7e280fc4c8fb",
"on_behalf_of": "customer",
"mode": "live",
"created_at": "2025-12-02T16:34:00.000000Z",
"updated_at": "2025-12-02T16:35:05.123456Z",
"status": "active",
"details": {
"instrument_type": "bank_account",
"currency": "AUD",
"account_owner_name": "Jane Smith",
"identifier": {
"identifier_type": "bsb_account",
"bsb": "123456",
"account_number": "12345678"
},
"verification": {
"status": "completed",
"result": "close_match",
"registered_account_name": "Jane A Smith",
"verified_at": "2025-12-02T16:35:05.123456Z",
"method": "cop"
}
}
}
}
Verification Completed: No Match
Note that registered_account_name may be absent for privacy reasons:
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"type": "payment_instrument_bank_account_verification_completed",
"version": "v3",
"data_version": 1,
"data": {
"payment_instrument_id": "c3f87070-c2d8-4dbd-8943-7e280fc4c8fb",
"on_behalf_of": "customer",
"mode": "live",
"created_at": "2025-12-02T16:34:00.000000Z",
"updated_at": "2025-12-02T16:35:08.654321Z",
"status": "active",
"details": {
"instrument_type": "bank_account",
"currency": "AUD",
"account_owner_name": "Jane Smith",
"identifier": {
"identifier_type": "bsb_account",
"bsb": "123456",
"account_number": "12345678"
},
"verification": {
"status": "completed",
"result": "no_match",
"verified_at": "2025-12-02T16:35:08.654321Z",
"method": "cop"
}
}
}
}
Do not proceed with a payout when a no_match result is received. Confirm the recipient's account details before retrying. See the CoP Verification Results guide for recommended actions.
Verification Failed
The status field is set to failed when the verification check could not be completed. Check latest_error.code for the cause:
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"type": "payment_instrument_bank_account_verification_completed",
"version": "v3",
"data_version": 1,
"data": {
"payment_instrument_id": "c3f87070-c2d8-4dbd-8943-7e280fc4c8fb",
"on_behalf_of": "customer",
"mode": "live",
"created_at": "2025-12-02T16:34:00.000000Z",
"updated_at": "2025-12-02T16:35:10.000000Z",
"status": "active",
"details": {
"instrument_type": "bank_account",
"currency": "AUD",
"account_owner_name": "Jane Smith",
"identifier": {
"identifier_type": "bsb_account",
"bsb": "123456",
"account_number": "12345678"
},
"verification": {
"status": "failed",
"method": "cop",
"latest_error": {
"code": "ACCOUNT_VERIFICATION_SERVICE_UNAVAILABLE",
"message": "Account verification service unavailable"
}
}
}
}
}
For a full list of error codes, see Verification Errors.
Next Steps
- CoP Verification Results - How to interpret match results and error codes
- Getting Started with CoP - Step-by-step implementation guide