Identification origination (1.0)

Download OpenAPI specification:Download

Identification Origination

Create identification origination for a customer

Creates an identification origination resource for a customer to be used for the identification and e-signing process for a Solarisbank product. The identification origination triggers a video identification for the customer and the e-signing process, in which the customer must provide a qualified electronic signature (QES) on the product agreement (e.g., loan contract) during the video identification process.

Request
Security:
path Parameters
person_id
required
string

The person ID of the customer for whom the identification origination is created.

Request Body schema: application/json

The application attributes

method
required
string

The identification method.

Value: "idnow"
Array of objects
Default: []

The documents to be uploaded for the customer to e-sign during the video identification process.

Responses
201

Identification

400

Invalid request

403

Forbidden

404

Not Found

409

Conflict

422

Unprocessable Entity

post/v1/identification_origination/persons/{person_id}/identifications
Request samples
application/json
{
  • "method": "idnow",
  • "additional_documents": [
    ]
}
Response samples
application/json
{
  • "status_description": "Waiting for signing process to finish",
  • "status": "esign_pending",
  • "identification_origination_id": "589e12da53154010ad180894acbe07ebio",
  • "identification_id": "17905779039e75dce7bf8d68f3184942cidt",
  • "esigning_id": "5ade4e499b299c299be2987ad597c42ecsig"
}

Retrieve a customer identification origination

Returns the details of a customer identification origination. Call this endpoint to check the identification_origination_status and get the esigning_id and the identification_id, which are required to prompt your customer to complete the e-signing and the video identification processes.

Request
Security:
path Parameters
person_id
required
string

The person ID of the customer who must complete the identification process.

identification_origination_id
required
string

The unique ID of an identification origination resource assigned to a specific customer.

Responses
200

Application

403

Forbidden

404

Not Found

get/v1/identification_origination/persons/{person_id}/identifications/{identification_origination_id}
Request samples
curl -i -X GET \
  'https://api.solaris-sandbox.de/v1/identification_origination/persons/{person_id}/identifications/{identification_origination_id}'
Response samples
application/json
{
  • "status_description": "Waiting for signing process to finish",
  • "status": "esign_pending",
  • "identification_origination_id": "589e12da53154010ad180894acbe07ebio",
  • "identification_id": "17905779039e75dce7bf8d68f3184942cidt",
  • "esigning_id": "5ade4e499b299c299be2987ad597c42ecsig"
}