Skip to main content
POST
/
v1
/
accounts
/
payee-verification
curl --request POST \
  --url https://api.vop-sandbox.finventi.com/v1/accounts/payee-verification \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "account_holder_name": "Name Example",
  "iban": "LT123456789012345678"
}
'
{
  "match_result": "CLOSE_MATCH",
  "reference_id": "123e4567-e89b-12d3-a456-426614174000",
  "timestamp": "2025-04-29T15:30:00Z",
  "real_name": "Alice Johnson"
}

Headers

​
Idempotency-Key
string
required

Idempotency key to prevent duplicate requests

Body

application/json

Payload containing:iban (string, mandatory); one of account_holder_name (string) OR organisation_identification (object); additional_attribute (string, optional)

​
iban
string
required

IBAN to verify

​
account_holder_name
string

Account holder name (natural person or legal entity) of the associated IBAN.

​
additional_attribute
string

Additional free-text metadata (e.g. payment context, internal ref)

​
organisation_identification
object

Legal-entity identifiers for the IBAN owner. Either lei, bic or other must be provided.

​
responding_psp_bic
string

11 character ISO code assigned by SWIFT and used to identify a financial institution in financial transactions.

Response

Verification result

​
match_result
enum<string>
required

Result of the VoP check: one of MATCH, CLOSE_MATCH, NO_MATCH, CANNOT_VERIFY

Available options:
MATCH,
CLOSE_MATCH,
NO_MATCH,
CANNOT_VERIFY
Example:

"CLOSE_MATCH"

​
reference_id
string
required

Unique ID associated with the VoP request (traceable for audit)

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
timestamp
string<date-time>
required

ISO 8601 datetime of when the check was processed

Example:

"2025-04-29T15:30:00Z"

​
real_name
string

Present if matchResult == CLOSE_MATCH; the best-matched account holder name

Example:

"Alice Johnson"