---
title: "Verify payee bank account"
method: POST
path: "/api/service/payee/verify"
tags: ["VoP"]
---

# Verify payee bank account

`POST /api/service/payee/verify`

Verify that the provided account holder name matches the bank account details. 

**Currently supported financial address types:**
- `iban`: IBAN-based accounts (EU/SEPA). It implements Verification of Payee (VoP) as required by EU Instant Payments Regulation.

**Possible status values:**
- `match`: Exact match - the name matches the account holder's name
- `partial_match`: Close match - similar but not identical (e.g., typos, abbreviations). The `suggestedAccountHolderName` field will contain the suggested account holder name.
- `no_match`: No match - the name does not match the account holder
- `not_available`: Verification not possible (e.g., bank unreachable, timeout, unsupported)

## Request body

- VopInputDto
  - `payee` object, required
    - `type` 'iban', required
    - `iban` object, required
      - `accountHolderName` string, required
      - `iban` string, required
      - `bic` string

## Response `200`

Verification completed successfully

- VopOutputDto
  - `status` 'match' | 'partial_match' | 'no_match' | 'not_available', required — The verification result status
  - `suggestedAccountHolderName` string

## Other responses

- `400` — Invalid request (e.g., unsupported financial address type)
- `401` — Unauthorized - invalid or missing API key
- `404` — Merchant not found

---

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