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

# Verify Beneficiary Account

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

## Request

- Base URL: `https://api.portone.cloud`
- URL: `https://api.portone.cloud/api/payout/vendor/account/verification`
- Auth: none declared

## 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.dev/portone/apis/payout-apis.md) - [All operations](https://skmtc.dev/portone/apis/payout-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/portone/apis/payout-apis/revisions/b2e255108469?raw)