Table of Contents
| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
🧪 Test accounts for automated testing
Country | National identity number | Certificate level | Response description |
|---|---|---|---|
EE | 🇪🇪 | 30303039914 | QUALIFIEDOK | Successful signing and identification |
LV | 🇱🇻 | 030303-10012 | QUALIFIEDOK | Successful signing and identification |
LT | 🇱🇹 | 30303039914 | QUALIFIEDOK | Successful signing and identification |
EE | 🇪🇪 | 30403039917 | QUALIFIEDUSER_REFUSED | User cancelled session |
LV | 🇱🇻 | 030403-10016 | QUALIFIEDUSER_REFUSED | User cancelled session |
LT | 🇱🇹 | 30403039917 | QUALIFIEDUSER_REFUSED | User cancelled session |
EE | 🇪🇪 | 30403039983 | QUALIFIEDTIMEOUT | User does not react |
LV | 🇱🇻 | 030403-10083 | QUALIFIEDTIMEOUT | User does not react |
LT | 🇱🇹 | 30403039983 | QUALIFIEDTIMEOUT | User does not react |
...
📍 Endpoints
| Status | ||||
|---|---|---|---|---|
|
...
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
This method is the main entry point to authentication logic. |
...
🎯 Request parameters
Parameter | Required or Optional? | Description |
|---|---|---|
country | Required | Country code here conforms to ISO 3166-1 alpha-2 code and as such must be in upper case ("LT", "LV", "EE"). |
nationalIdentityNumber | Required | National identification number |
certificateLevel | Required | Level of certificate requested "QUALIFIED". |
displayText | Optional | Text to display for authentication consent dialog on the mobile device. Limited to 60 characters or 128 bytes in UTF-8 encoding, whichever is reached first. |
...
🥫 Response structure
Parameter | Required or Optional? | Description |
|---|---|---|
sessionId | Required | A string that can be used to request operation result. |
verificationCode | Required | Verification code is needed, so that user can bind together the session on the browser and the authentication request on the Smart-ID app. |
...
Session is present in the system, and the request is either running or has been completed less than 5 minutes ago. Timeout period is 120 seconds.
...
🥫 Response structure
Parameter | Required or Optional? | Description |
|---|---|---|
countryCode | Required | Country code |
nationalIdentityNumber | Required | National identification number |
name | Required | Person name |
surname | Required | Person surname |
...
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
This method is the main entry point to signing logic. |
...
🎯 Request parameters
Parameter | Required or Optional? | Description |
|---|---|---|
countryCode | Required | Country code here conforms to ISO 3166-1 alpha-2 code and as such must be in upper case ("LT", "LV", "EE"). |
nationalIdentityNumber | Required | National identification number |
displayText | Optional | Text to display for authentication consent dialog on the mobile device. Limited to 60 characters or 128 bytes in UTF-8 encoding, whichever is reached first. |
file | Required | Data to sign |
...
🥫 Response parameters
Parameter | Required or Optional? | Description |
|---|---|---|
sessionId | Required | A string that can be used to request operation result. |
verificationCode | Required | Verification code is needed, so that user can bind together the session on the browser and the authentication request on the Smart-ID app. |
...
🧪 Test accounts for automated testing
Country | Phone number | National identity number | Response description |
|---|---|---|---|
EE | 🇪🇪 | +37269930366 | 51307149560 | Successful signing and identification |
LT | 🇱🇹 | +37069930366 | 60706225732 | Successful signing and identification |
EE | 🇪🇪 | +37200000266 | 60001019939 | Mobile-ID user has no active certificates |
LT | 🇱🇹 | +37060000266 | 50001018832 | Mobile-ID user has no active certificates |
EE | 🇪🇪 | +37207110066 | 60001019947 | Sending authentication request to phone failed |
LT | 🇱🇹 | +37067110066 | 50001018843 | Sending authentication request to phone failed |
EE | 🇪🇪 | +37201100266 | 60001019950 | User cancelled authentication |
LT | 🇱🇹 | +37061100266 | 50001018854 | User cancelled authentication |
EE | 🇪🇪 | +37200000666 | 60001019961 | Created signature is not valid |
LT | 🇱🇹 | +37060000766 | 50001018800 | Created signature is not valid |
EE | 🇪🇪 | +37201200266 | 60001019972 | SIM application error |
LT | 🇱🇹 | +37061200266 | 50001018876 | SIM application error |
EE | 🇪🇪 | +37213100266 | 60001019983 | Phone is not in coverage area |
LT | 🇱🇹 | +37063100266 | 50001018887 | Phone is not in coverage area |
EE | 🇪🇪 | +37266000266 | 50001018908 | User does not react |
LT | 🇱🇹 | +37066000266 | 50001018908 | User does not react |
...
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
This method is the main entry point to authentication logic. |
...
🎯 Request parameters
Parameter | Required or Optional? | Description |
|---|---|---|
phoneNumber | Required | Phone number of the signer with the country code in the format of +xxxxxxxxx |
nationalIdentityNumber | Required | National identification number |
language | Required | Language for user dialog in mobile phone. 3-letters capitalized acronyms are used. Possible values: EST, ENG, RUS, LIT. NB! If you use language="LIT" to send to Estonian number (+372...) or you use language="EST" to send to Lithuanian number (+370...) then internally language is replaced with "ENG". |
displayText | Optional | Text to display for authentication consent dialog on the mobile device. Limited to 40 characters including up to 5 characters from extension table ( €[]^|{}\ ). |
...
🥫 Response parameters
Parameter | Required or Optional? | Description |
|---|---|---|
sessionId | Required | A string that can be used to request operation result. |
verificationCode | Required | Verification code is needed, so that user can bind together the session on the browser and the authentication request on mobile device. |
...
https://sandbox-esignature.ondato.com/mobile-id/authentication/{sessionId}
...
🥫 Response parameters
Parameter | Required or Optional? | Description |
|---|---|---|
countryCode | Required | Country code |
nationalIdentityNumber | Required | National identification number |
name | Required | Person name |
surname | Required | Person surname |
...
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
This method is the main entry point to signing logic. |
...
🎯 Request parameters
Parameter | Required or Optional? | Description |
|---|---|---|
phoneNumber | Required | Phone number of the signer with the country code in the format of +xxxxxxxxx |
nationalIdentityNumber | Required | National identification number |
language | Required | Language for user dialog in mobile phone. 3-letters capitalized acronyms are used. Possible values: EST, ENG, RUS, LIT. NB! If you use language="LIT" to send to Estonian number (+372...) or you use language="EST" to send to Lithuanian number (+370...) then internally language is replaced with "ENG". |
displayText | Optional | Text to display for authentication consent dialog on the mobile device. Limited to 60 characters or 128 bytes in UTF-8 encoding, whichever is reached first. |
file | Required | File to sign |
...
🥫 Response parameters
Parameter | Required or Optional? | Description |
|---|---|---|
sessionId | Required | A string that can be used to request operation result. |
verificationCode | Required | Verification code is needed, so that user can bind together the session on the browser and the authentication request on mobile device. |
...