Request Ident Link

The client has successfully entered their information and this has been transmitted to Concedus. If the client has in some way lost the link to the KYC provider, it has expired or there were other problems with identification, VgV can now request the still active link and a new link itself.

Request Ident-Link

POST https://demo2.api.concedus.com/v2/compliance/idents

Headers

Name	Type	Description
Content-Type*	String	application/json
Authorization*	String	Bearer token

Request Body

Field	Type	Requirement	Description
personKey	String	required	See: Key
kycServiceName	String	required	Chosen KYC-Provider See: KYC-Provider

Request structure (JSON)

{
  "personKey": "PERS_XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "kycServiceName": "WEBID"
}

Response Body

200: OK - New Ident when last is expired

{
    "idents": [
        {
            "kyc": "WEBID",
            "url": "https://test.webid-solutions.de/service/qa/cn/000713/aid/264618XXX",
            "key": "PERS_XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
            "actionId": "264618XXX",
            "status": "pending",
            "transactionId": "XXX909ddXXXaXXXdbbeXXXc13de69XXX"
        }
    ]
}

200: OK - Latest Ident still pending

400: Bad Request - Ident already successfull

400: Bad Request - Not expired and failed 3 times

404: Not Found