Skip to content
Download OpenAPI description
Languages
Servers
Mock Server

https://docs.solarisgroup.com/_mock/api-reference/digital-banking/sepa-transfers/

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations

Submit a new verification of payee

Request

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

Bodyapplication/jsonrequired
ibanstringrequired

The International Bank Account Number (IBAN) of the payee

Example: "DE89370400440532013000"
namestring<= 140 characters^[\p{L}\p{M}\p{N}\p{P}\p{S}\s]+$required

The name of the payee to verify

Example: "John Doe"
application/json
{ "iban": "DE89370400440532013000", "name": "John Doe" }

Responses

Verification request successfully submitted

Bodyapplication/json
idstringrequired

Solaris UID for the verification of payee

Example: "123e4567e89b12d3a456426614174000veop"
payeeobjectrequired

The payee information that was verified

payee.​ibanstringrequired

The IBAN of the payee

Example: "DE89370400440532013000"
payee.​namestringrequired

The name of the payee

Example: "John Doe"
resultobjectrequired

The result of the verification of payee

result.​statusstringrequired

The status of the verification of payee

Enum"MATCH""NO_MATCH""CLOSE_MATCH""VERIFICATION_NOT_POSSIBLE""VERIFICATION_NOT_SUPPORTED"
Example: "CLOSE_MATCH"
result.​suggested_namestring

Suggested correct name when there is a close match but not exact

Example: "John M. Doe"
created_atstring(date-time)required

The timestamp when the verification was created

Example: "2025-04-16T12:34:56Z"
expires_atstring(date-time)required

The timestamp when the verification expires

Example: "2025-04-16T12:39:56Z"
used_forobject

The process the verification was used for. Will be present only if verification was already used for a process (e.g. SEPA_CREDIT_TRANSFER).

Response
application/json
{ "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" }

Request

Retrieve details of a specific verification of payee by its unique identifier

Path
idstring(uuid)required

The unique identifier of the verification of payee

Example: 123e4567-e89b-12d3-a456-426614174000
No request payload

Responses

Successful response

Bodyapplication/json
idstringrequired

Solaris UID for the verification of payee

Example: "123e4567e89b12d3a456426614174000veop"
payeeobjectrequired

The payee information that was verified

payee.​ibanstringrequired

The IBAN of the payee

Example: "DE89370400440532013000"
payee.​namestringrequired

The name of the payee

Example: "John Doe"
resultobjectrequired

The result of the verification of payee

result.​statusstringrequired

The status of the verification of payee

Enum"MATCH""NO_MATCH""CLOSE_MATCH""VERIFICATION_NOT_POSSIBLE""VERIFICATION_NOT_SUPPORTED"
Example: "CLOSE_MATCH"
result.​suggested_namestring

Suggested correct name when there is a close match but not exact

Example: "John M. Doe"
created_atstring(date-time)required

The timestamp when the verification was created

Example: "2025-04-16T12:34:56Z"
expires_atstring(date-time)required

The timestamp when the verification expires

Example: "2025-04-16T12:39:56Z"
used_forobject

The process the verification was used for. Will be present only if verification was already used for a process (e.g. SEPA_CREDIT_TRANSFER).

Response
application/json
{ "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" }

(Legacy) SEPA Direct Debit for freelancers

Operations

(Legacy) SEPA Direct Debit for business

Operations

(Legacy) SEPA Direct Debit profile templates

Operations