---
title: "Create bank account verification request"
method: POST
path: "/merchants/{merchantId}/banv"
tags: ["Bank Account Verification"]
---

# Create bank account verification request

`POST /merchants/{merchantId}/banv`

Start a bank account verification request.

For more information, see the [documentation](https://developer.peachpayments.com/docs/payouts-api-1#create-bank-account-verification-request-flow), and for sample calls, see the [public Postman collection](https://www.postman.com/peachpayments/peach-payments-public-workspace/request/13324425-1e82710e-b448-4459-be45-bd947fb4e9cf).

## Path parameters

- `merchantId` string, required — A unique merchant ID provided by Peach Payments in hexadecimal format.

## Request body

- BankAccountVerificationRequest — All the details required for a bank account verification request.
  - `accountNumber` string, required
  - `accountType` 'current_cheque_account' | 'savings_account' | 'transmission_account' | 'bond_account' | 'subscription_share' | 'unknown', required
  - `branchCode` string, required
  - `idNumber` string, required — SAID number, passport number, or company registration. The API strips any '/' or '\\' characters before processing.
  - `initials` string
  - `lastName` string

## Response `200`

The bank account verification request was received and will be processed.

- BankAccountVerificationRequestAcknowledgement — An acknowledgement that the bank account verification request was received and will be processed.
  - `message` string, required
  - `bankVerificationId` string, required — A valid v4 UUID expressed in lowercase with dashes.
  - `status` 'pending' | 'processing' | 'successful' | 'failed', required — The current status of the bank account verification request.
  - `resultCode` string, string, required — The result code indicating the status or error of the payout.

## Other responses

- `400` — There was an error with the request. Please fix the request and try again.
- `401` — The request is not authenticated. Please re-authenticate and provide a new token.
- `403` — The request is not authorised. Please contact your business administrator.

---

[API](https://skmtc.net/peachpayments/apis/checkout.md) · [All operations](https://skmtc.net/peachpayments/apis/checkout/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peachpayments/checkout/revisions/3a98165665f8/schema)