---
title: "Verify Beneficiary Account"
method: POST
path: "/api/payout/vendor/account/verification"
tags: ["Payout APIs"]
---

# Verify Beneficiary Account

`POST /api/payout/vendor/account/verification`

## Headers

- `X-Portone-Client-Key` string
- `Authorization` string

## Request body

- object
  - `portone_key` string, required — The unique PortOne key for merchant
  - `channel_key` string, required — The Payment Channel Key listed in PortOne docs
  - `bank_name` string, required — The bank name where the Beneficiary has their bank account
  - `bank_number` string, required — The bank number of the Beneficiary
  - `account_number` string, required — The account number of the Beneficiary
  - `account_name` string, required — The account name of the Beneficiary
  - `request_id` string, required — The request_id of verification request
  - `type` 'BANK' | 'CARD', required — The account type of the Benificiary
  - `signature_hash` string — The SignatureHash generated for the specific payload data
  - `environment` 'live' | 'sandbox', required — The environment of the transaction is either live OR sandbox

## Response `200`

Successful response

- object
  - `is_verified` string — The boolean flag indicating whether the beneficiary account is verified or not.
  - `bank_number` string — The bank number mapped with the beneficiary account.
  - `account_number` string — The account number of the beneficiary.
  - `account_name` string — The name of the beneficiary account.
  - `request_id` string — The request_id for verification generated by PSP.

## Other responses

- `400` — Failure response
- `401` — Failure response

---

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