Verify payee details

Important

The sepaPayee purpose (VoP) MUST NOT be used for advanced verification of payees.
The VoP service forbids requests being raised that are not intended for payment. If the ratio of requests raised without payments being booked becomes too high, access to this endpoint will be restricted.

Payments over the SEPA network require that account details are verified before booking the payment.

The correct process is:

Be ready to place a payment (amount, destination, etc.)

Raise a verification request (this endpoint) for the destination account using the sepaPayee purpose

When booking the payment, set verification.requestId to the response ID

If the response did not give status match, the payment cannot continue. Either the verification request should be retried, in case it was a temporary issue, or the issue can be ignored by setting verification.acceptWarning to true

The same requestId may be returned for requests made within a short period. Each ID may only be used for a single payment, so it is important that requests are made directly before the payment is booked.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://api.demo.getneo.com/v3/counterparties/accounts/verify' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "counterpartyId": "abcdefghijkl0123456789", "bankAccountId": "abcdefghijkl0123456789", "purpose": "sepaPayee" }'

{ "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6", "purpose": "sepaPayee", "timestamp": "2019-08-24T14:15:22.123Z", "expireTime": "2019-08-24T14:15:22.123Z", "responseState": "match", "suggestedName": "string" }

Verify payee details

Request

Responses