latestOpenAPI 3.1.02026-08-105546268.4 KB

f1fef352d976

Verification of Payee

Submit a new verification of payee

Create a new verification of payee to validate if the provided name matches the account holder of the given IBAN.

post/v1/verifications_of_payee

Request body

ibanstring required

The International Bank Account Number (IBAN) of the payee

namestring required

The name of the payee to verify

Example request

{
  "iban": "DE89370400440532013000",
  "name": "John Doe"
}

Response

Verification request successfully submitted

idstring required

Solaris UID for the verification of payee

created_atstring date-time required

The timestamp when the verification was created

expires_atstring date-time required

The timestamp when the verification expires

Example response

{
  "id": "123e4567e89b12d3a456426614174000veop",
  "payee": {
    "iban": "DE89370400440532013000",
    "name": "John Doe"
  },
  "result": {
    "status": "CLOSE_MATCH",
    "suggested_name": "John M. Doe"
  },
  "used_for": {
    "type": "SCT",
    "id": "f874b3102718a4d757a6b6e4d5996078sctx",
    "timestamp": "2025-04-16T12:36:30Z"
  },
  "created_at": "2025-04-16T12:34:56Z",
  "expires_at": "2025-04-16T12:39:56Z"
}