---
updatedAt: 2026-04-27T08:29:42.000Z
agentTools:
  projectIndex: https://partner.getpliant.com/llms.txt
---

# Create Payee Verification

> 🔒 **Required scope:** `money-movement:write`
>
> The API credential calling this endpoint must be granted the `money-movement` category with `read & write` access.
> Scopes are assigned to the credential when it is created or edited in Pliant, not requested when obtaining the access token.
> A credential without this scope receives `403 Forbidden` with the error code `INSUFFICIENT_PERMISSION`.

Verify that a bank account belongs to the named person or company before initiating a transfer.

This endpoint implements the **Verification of Payee (VoP)** name-check service, mandatory under the SEPA Instant Payments Regulation (IPR) for SCT and SCT Inst transfers since 9 October 2025. A real-time request is sent to the recipient's bank to compare the submitted account holder name against their records.

**Typical flow:**
1. Call this endpoint before creating an external transfer.
2. Inspect the `result.matchLevel` in the response and decide whether to proceed.
3. Attach the returned `verificationId` as `vopId` in the external transfer creation request.
4. Verifications are valid for **60 minutes** (`status: ACTIVE`). If re-verification is requested within that window, the same `verificationId` is returned.

**Match level guidance:**

| `matchLevel` | Meaning | Recommended action |
|---|---|---|
| `MATCH` | Name and IBAN align perfectly | Proceed with confidence |
| `CLOSE_MATCH` | Minor discrepancy (e.g. typo) | Review `result.accountHolder` for the suggested correct name |
| `NO_MATCH` | Name belongs to a different person | Abort — high fraud risk |
| `UNAVAILABLE` | Recipient bank unreachable or unsupported | Proceed with caution |


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "contact": {
      "name": "API Support",
      "email": "support@getpliant.com",
      "url": "https://www.getpliant.com"
    },
    "title": "Pliant Partner API",
    "description": "Pliant Partner API",
    "version": "2.1.0",
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/license/MIT"
    }
  },
  "servers": [
    {
      "url": "https://partner-api.getpliant.com/api",
      "description": "Pliant Production Server"
    },
    {
      "url": "https://sandbox.partner-api.getpliant.com/api",
      "description": "Pliant Sandbox Server"
    },
    {
      "url": "https://pci-api.getpliant.com",
      "description": "PCI Vault Production Server"
    },
    {
      "url": "https://pci-sandbox.partner-api.getpliant.com",
      "description": "PCI Vault Sandbox Server"
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "samples-languages": [
      "curl",
      "java",
      "kotlin"
    ],
    "headers": [
      {
        "key": "Pliant-API-Version",
        "value": "2.1.0"
      }
    ]
  },
  "tags": [
    {
      "name": "Verification of Payee",
      "description": "This tag is for operations related to Verification of Payee (VoP) — name-check service mandatory under the SEPA Instant Payments Regulation"
    }
  ],
  "paths": {
    "/vop/verification": {
      "post": {
        "summary": "Create Payee Verification",
        "description": "> 🔒 **Required scope:** `money-movement:write`\n>\n> The API credential calling this endpoint must be granted the `money-movement` category with `read & write` access.\n> Scopes are assigned to the credential when it is created or edited in Pliant, not requested when obtaining the access token.\n> A credential without this scope receives `403 Forbidden` with the error code `INSUFFICIENT_PERMISSION`.\n\nVerify that a bank account belongs to the named person or company before initiating a transfer.\n\nThis endpoint implements the **Verification of Payee (VoP)** name-check service, mandatory under the SEPA Instant Payments Regulation (IPR) for SCT and SCT Inst transfers since 9 October 2025. A real-time request is sent to the recipient's bank to compare the submitted account holder name against their records.\n\n**Typical flow:**\n1. Call this endpoint before creating an external transfer.\n2. Inspect the `result.matchLevel` in the response and decide whether to proceed.\n3. Attach the returned `verificationId` as `vopId` in the external transfer creation request.\n4. Verifications are valid for **60 minutes** (`status: ACTIVE`). If re-verification is requested within that window, the same `verificationId` is returned.\n\n**Match level guidance:**\n\n| `matchLevel` | Meaning | Recommended action |\n|---|---|---|\n| `MATCH` | Name and IBAN align perfectly | Proceed with confidence |\n| `CLOSE_MATCH` | Minor discrepancy (e.g. typo) | Review `result.accountHolder` for the suggested correct name |\n| `NO_MATCH` | Name belongs to a different person | Abort — high fraud risk |\n| `UNAVAILABLE` | Recipient bank unreachable or unsupported | Proceed with caution |\n",
        "x-required-scopes": [
          "money-movement:write"
        ],
        "tags": [
          "Verification of Payee"
        ],
        "operationId": "create-vop-verification",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VopVerificationRequest"
              },
              "example": {
                "accountHolder": "Ame Corporation GmbH",
                "type": "VERIFICATION_OF_PAYEE",
                "vop": {
                  "accountNumber": "DE89370400440532013000"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Ok",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VopVerification"
                },
                "example": {
                  "verificationId": "550e8400-e29b-41d4-a716-446655440000",
                  "request": {
                    "accountHolder": "Ame Corporation GmbH",
                    "accountNumber": "DE89370400440532013000"
                  },
                  "result": {
                    "accountHolder": "ACME Corporation GMBH",
                    "matchLevel": "CLOSE_MATCH",
                    "resultDetails": "The name is a close match."
                  },
                  "status": "ACTIVE",
                  "activeUntil": "2025-10-09T11:30:00Z",
                  "createdAt": "2025-10-09T10:30:00Z"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "500": {
            "$ref": "#/components/responses/500"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "This API uses oAuth2 with client credentials flow to [obtain the Bearer Token](/docs/authenticated-api-usage).",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "VopVerification": {
        "type": "object",
        "properties": {
          "verificationId": {
            "type": "string",
            "format": "uuid",
            "description": "Unique identifier of the payee verification. Use this value as `vopId` when initiating an external transfer."
          },
          "request": {
            "type": "object",
            "description": "A flattened echo of the key fields from the original verification request.\nNote: this is a simplified read-only view — the `accountNumber` is returned\ndirectly here rather than nested under `vop` as in the request body.\n",
            "properties": {
              "accountHolder": {
                "type": "string",
                "description": "The account holder name as submitted by the client.",
                "example": "Ame Corporation GmbH"
              },
              "accountNumber": {
                "type": "string",
                "description": "The IBAN of the payee account.",
                "example": "DE89370400440532013000"
              }
            }
          },
          "result": {
            "type": "object",
            "description": "The verification result returned by the provider.",
            "nullable": true,
            "properties": {
              "accountHolder": {
                "type": "string",
                "description": "The account holder name as known by the recipient bank.",
                "example": "ACME Corporation GMBH",
                "nullable": true
              },
              "matchLevel": {
                "type": "string",
                "description": "The match level between the submitted name and the name on the account.\n* `MATCH` — Name and IBAN align perfectly. Proceed with confidence.\n* `CLOSE_MATCH` — Slight discrepancy (e.g. \"Jon Doe\" vs \"John Doe\"). The `result.accountHolder` contains the suggested correct name.\n* `NO_MATCH` — Name belongs to a different person. High fraud risk; advised to abort the transfer.\n* `UNAVAILABLE` — Recipient bank is unreachable or does not support VoP. Proceed with caution.\n",
                "enum": [
                  "MATCH",
                  "CLOSE_MATCH",
                  "NO_MATCH",
                  "UNAVAILABLE"
                ],
                "nullable": true
              },
              "resultDetails": {
                "type": "string",
                "description": "Human-readable description of the match result.",
                "example": "The name is a close match.",
                "nullable": true
              }
            }
          },
          "status": {
            "type": "string",
            "description": "Lifecycle status of the verification record.\n* `ACTIVE` — The verification is valid and can be referenced in a transfer (within 60 minutes of creation).\n* `INACTIVE` — The verification has expired or has already been consumed.\n",
            "enum": [
              "ACTIVE",
              "INACTIVE"
            ]
          },
          "activeUntil": {
            "type": "string",
            "format": "date-time",
            "description": "The timestamp until which this verification is considered valid and can be attached to a transfer. Verifications expire 60 minutes after creation.",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the verification was created."
          }
        }
      },
      "VopVerificationRequest": {
        "type": "object",
        "required": [
          "accountHolder",
          "type",
          "vop"
        ],
        "properties": {
          "accountHolder": {
            "type": "string",
            "description": "The name of the account holder to verify against the recipient bank.",
            "example": "Ame Corporation GmbH"
          },
          "type": {
            "type": "string",
            "description": "The type of verification to perform. Must be `VERIFICATION_OF_PAYEE`.",
            "enum": [
              "VERIFICATION_OF_PAYEE"
            ]
          },
          "vop": {
            "type": "object",
            "description": "Payee account details for the verification.",
            "required": [
              "accountNumber"
            ],
            "properties": {
              "accountNumber": {
                "type": "string",
                "description": "The IBAN of the payee account to verify.",
                "example": "DE89370400440532013000"
              }
            }
          }
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "string",
            "description": "The error code"
          },
          "exceptionId": {
            "type": "string",
            "format": "uuid",
            "description": "The id of the exception that was thrown"
          },
          "message": {
            "type": "string",
            "description": "The cause of the error or further explanations on the error"
          }
        }
      }
    },
    "responses": {
      "400": {
        "description": "Bad Request. The API consumer sent a malformed request which could not be processed.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "401": {
        "description": "Unauthorized. The API consumer is not authorized to access the requested resource.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "403": {
        "description": "Forbidden. The API consumer is not allowed to access the requested resource.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "422": {
        "description": "Unprocessable Content. The request could not be completed due to contents of the request. The syntax of the request content was correct.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "429": {
        "description": "Too Many Requests. The API consumer has sent too many requests in a given amount of time. Please check our [API guidelines](/docs/pliant-api-guidelines#api-rate-limits).",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "error": {
                  "type": "string",
                  "description": "Detailed description of the error and breached rate limit."
                }
              }
            }
          }
        }
      },
      "500": {
        "description": "Internal Server Error. The request was not completed due to an internal error.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```