---
title: "Create an account name check for Direct Debit Payer"
method: POST
path: "/account-name-check/payer"
tags: ["Confirmation of Payee"]
---

# Create an account name check for Direct Debit Payer

`POST /account-name-check/payer`

Payer Name Verification (PNV) automatically checks that your payer’s name matches the name on the bank account details submitted when setting up BACS Direct Debits. This reduces your exposure to fraud and failed payment setups
This endpoint does not support idempotent requests. Any requests containing an x-mod-nonce header used by a previous request will return the response <code>403: Forbidden ("Unique/allowed nonce header not found")</code>

## Request body

- ConfirmationofpayeeJsonOutboundCopRequest — Details of Account Name Check Request
  - `paymentAccountId` string, required — The identifier of the account that a subsequent payment will be initiated from.
  - `sortCode` string, required — The sort code of the account.
  - `accountNumber` string, required — The account number.
  - `secondaryAccountId` string — Additional information used in conjunction with the Sort Code and Account Number to identify the account (such as a Building Society roll number).
  - `accountType` 'PERSONAL' | 'BUSINESS', required — The type of account, either a personal or business account.
  - `name` string, required — The name to match the account name against.

## Response `201`

Created

- ConfirmationofpayeeJsonOutboundCopResponse — Account Name Check Response
  - `id` string, required — Unique id for the account name check.
  - `result` ConfirmationofpayeeJsonOutboundCopResult, required — Account Name Check Result
    - `code` 'MATCHED' | 'NOT_MATCHED' | 'CLOSE_MATCH' | 'BUSINESS_ACCOUNT_NAME_MATCHED' | 'PERSONAL_ACCOUNT_NAME_MATCHED' | 'BUSINESS_ACCOUNT_CLOSE_MATCH' | 'PERSONAL_ACCOUNT_CLOSE_MATCH' | 'ACCOUNT_DOES_NOT_EXIST' | 'SECONDARY_ACCOUNT_ID_NOT_FOUND' | 'ACCOUNT_NOT_SUPPORTED' | 'ACCOUNT_SWITCHED' | 'WRONG_PARTICIPANT' | 'NO_RESPONSE' | 'NOT_ENROLLED', required — The result of the account name check.
    - `name` string — The actual name on the account (as provided by the participating organisation).

## Other responses

- `400` — Validation Errors
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/versions/cbd52524c8ef/schema)
