VOP scheme supports IBAN / ID check for legal persons, where ID can be any standard business identification code.

List supported identification types

Prior sending a VOP request, you should make sure the payee's agent supports the identification you want to check. You can do this with the following request:

curl --request GET \
     --url 'https://api.numeral.io/v1/vop_supported_identification_types?payee_account_number=FR5714508000406767772588K59' \
     --header 'accept: application/json' \
     --header 'x-api-key: ***123'

You will then receive the list of identification types supported by the PSP holding this account, or an error code if the PSP is not a VOP participant.

{
  "PayeeAccount": "FR5714508000406767772588K59",
  "PayeeAgent": "BDFEFRPPXXX",
  "SupportedIdentificationType": ["name", "lei", "fr_siren"]
}

{
  "error": "validation_error",
  "message": "validation errors occurred while processing request",
  "details": [
    {
      "field": "payee_account_number",
      "reason": "payee agent is not participant"
    }
  ]
}

Supported identification types in VOP

On this page, you will find common identifier codes in selected European countries. Please note that by design, and as per the EPC VOP scheme requirements, Numeral supports any identifier code in both incoming and outgoing requests.