---
title: "Verify Bank Account"
method: POST
path: "/api/v1/merchant/bank/verify-account"
tags: ["Identity Verification"]
---

# Verify Bank Account

`POST /api/v1/merchant/bank/verify-account`

Verify a bank account against a BVN, bank code, and bank account number.

## Headers

- `api-key` string, required
- `api-secret` string, required
- `Content-Type` 'application/json', required

## Request body

- BankAccountVerificationRequest
  - `bvn` string, required — Customer BVN
  - `bank_code` string, required — Bank code
  - `bank_account` string, required — Bank account number

## Response `200`

Bank account verification response

- BankAccountVerificationResponse
  - `success` boolean, required
  - `message` string, required
  - `data` BankAccountVerificationData, required
    - `verify_result` boolean, required — Whether the bank account verification succeeded
    - `bank_account_name` string, required — Resolved bank account name
    - `name_match_percentage` integer, required — Percentage name match score
  - `charges` VerificationCharges, required
    - `charged` boolean, required — Whether the verification request was billed
    - `charged_amount` string, required — Amount charged for the verification request

## Other responses

- `402` — Verification could not be processed because the wallet balance is insufficient

---

[API](https://skmtc.net/payvessel/apis/payvessel-value-added-services-api.md) · [All operations](https://skmtc.net/payvessel/apis/payvessel-value-added-services-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payvessel/payvessel-value-added-services-api/revisions/31040a9358ef/schema)