Transaction Number
Linking a Transaction Number to an existing User
Let's assume there is an existing user with complete data in your database whose identity you need to verify. IDnow allows for adding a unique transactionnumber (recommended) of your choice to every Ident creation request. You can use this number to associate the Ident e.g. with the corresponding entity in your system. When retrieving an Ident, this number will be provided back to you as the transactionnumber in the JSON body.
Transaction Number
A Transaction number is a unique reference number which you generate on your end. This is your internal reference number for an identification request. It is required that the Transaction number generated by your system meets these requirements:
It is unique per Ident that you create It is not guessable It has a maximum length of 255 characters. A typical example is a UUID (version 4) as the value It may contain only the following characters: [a-z][A-Z][0-9][_-] to be compatible with the IDnow system The transaction number is case-insensitive and is used in the URL of the API Request.
Additionally, the IDnow system (internally) assigns each identification another ID which is called IdentID and is also visible for the user. It takes the form of ABC-DEFGH.
Transaction numbers that you generate are unique to a shortname. The same Transaction number cannot be reused for the same shortname. In case a Transaction number was deleted, the same Transaction number cannot be reused to create another Ident request.