> For the complete documentation index, see [llms.txt](https://docs.transactionlink.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.transactionlink.io/docs/v1/integrations/ondato.md). # OnDato ### What kind of data I will get By using this integration you will be able to verify identity of your customers. ### Integration Scope KYC - An identity verification service is used by businesses to ensure that users or customers provide information that is associated with the identity of a real person. ### Input You can configure users' input that will be send to OnDato in order to get the most of the verifications. | Attribute | Type | Description | | ----------- | ------ | ------------------------------------ | | email | string | Email of the user (Required). | | firstName | string | First name of the user (Optional). | | middleName | string | Middle name of the user (Optional). | | lastName | string | Last name of the user (Optional). | | dateOfBirth | string | Date of birth of the user(Optional). | | pesel | string | Pesel of the user(Optional). | | phoneNumber | string | Phone number of the user (Optional). | | countryCode | string | Country code of user (Optional). | ### Output
AttributeTypeDescription
statestringPossible values include:
- INIT
- IN_PROGRESS
- FAILED
- COMPLETED
- COMPLETED_WITH_ERRORS
identityVerificationobject
kycVerificationobject
### Identity Verification | Attribute | Type | Description | | ----------------------------------------------- | -------------- | ------------------------------------------- | | applicationId | string | Identifier for the application | | [communicationChannels](#communication-channel) | array\ | List of communication channels | | createdUtc | string | Creation date and time (UTC) | | externalReferenceId | string | External reference identifier | | id | string | Identifier for the data record | | modifiedUtc | string | Modification date and time (UTC) | | [redaction](#redaction) | object | Redaction information | | [registration](#registration) | object | User registration details | | [setup](#setup) | object | Setup information | | status | string | Status of the data record (e.g., "Pending") | | [step](#step) | object | Workflow step details | ### Communication Channel | Attribute | Type | Description | | --------- | ------ | ---------------------------------- | | id | string | Id of the communication channel. | | type | string | Type of the communication channel. | ### Redaction | Attribute | Type | Description | | ----------- | ------ | ----------------------------- | | redactedUtc | string | Redaction date and time (UTC) | ### Registration | Attribute | Type | Description | | ------------ | ------ | ------------------------- | | dateOfBirth | string | Date of birth | | email | string | Email address | | firstName | string | First name | | lastName | string | Last name | | middleName | string | Middle name | | personalCode | string | Personal code | | phoneNumber | number | Phone number | | countryCode | string | Country code (e.g., "LT") | ### Setup | Attribute | Type | Description | | ---------- | ------ | ----------- | | id | string | Setup ID | | overrideId | string | Override ID | | versionId | string | Version ID | ### Step | Attribute | Type | Description | | ------------------------------------------- | ------ | -------------------------- | | [consent](#consent) | object | Consent details | | [kycIdentification](#kyc-identification-id) | object | KYC identification details | ### Consent | Attribute | Type | Description | | ------------ | ------- | ----------------------------- | | consentedUtc | string | Consent date and time (UTC) | | id | string | Consent ID | | isConsented | boolean | Indicates if consent is given | ### **KYC Identification Id** | Attribute | Type | Description | | --------- | ------ | ---------------------- | | id | string | Face authentication ID | ### Kyc Identification | Attribute | Type | Description | | ------------------------------------ | ----------------------- | ----------------------------------------------------------------- | | [additionalFiles](#additional-files) | array\ | List of additional files | | applicationId | string | Identifier for the application | | [auditFiles](#audit-files) | array\ | List of audit files | | completedUtc | string | Completion date and time (UTC) | | createdUtc | string | Creation date and time (UTC) | | [document](#document) | object | Document details | | [face](#face) | object | Face details | | [fraudChecks](#fraud-checks) | array\ | List of fraud checks | | id | string | Identifier for the data record | | identityVerificationId | string | Identifier for identity verification | | isCrossChecked | boolean | Indicates if cross-checked | | [proofOfAddress](#proof-of-address) | object | Proof of address details | | [registries](#registries) | array\** | List of registries | | [rules](#rules) | array\ | List of rules | | [scores](#scores) | array\ | List of scores | | [setup](#setup-1) | object | Setup information | | status | string |

Possible values:
- Awaiting
- Approved
- Rejected

| | statusReason | string | Possible value in table below |
StatusStatus reasons
Awaiting
  • Unfinished
  • Processing
Approved
  • AutomaticallyIdentified
  • ManuallyIdentified
Rejected
  • TransferToVideoCall
  • MissingDocumentPhoto
  • DocumentNotAccepted
  • DataNotMatch
  • DataNotMatch
  • Sanctioned
  • MissingPersonPhoto
  • FacesNotMatch
  • PoorPhotoQuality
  • PoorPhotoLighting
  • FacePhotoUploadFormat
  • Miscellaneous
  • PossibleFraudAttempt
  • UnrelatedPhotoSubmit
  • MoreThanOnePerson
  • ProhibitedCountryOrState
  • DocumentIsExpired
  • DocumentWithNonLatinCharacters
  • PartOfDocumentIsCovered
  • PartOfFaceIsCovered
  • UnderagePerson
  • ProhibitedNationality
  • DuplicatedInfo
  • AdverseMediaFound
  • DocumentFromScreen
  • DocumentManipulation
  • DocumentPrinted
  • InvalidProofOfAddress
  • KnownFraudster
  • PoliticallyExposedPerson
  • SelfieHasNoFace
### **Additional Files** | Attribute | Type | Description | | ------------- | ------ | ---------------------------- | | createdUtc | string | Creation date and time (UTC) | | fileExtension | string | File extension | | fileId | string | File identifier | | fileName | string | File name | | fileType | string | File type | ### **Audit Files** | Attribute | Type | Description | | ------------- | ------ | ---------------------------- | | createdUtc | string | Creation date and time (UTC) | | fileExtension | string | File extension | | fileId | string | File identifier | | fileName | string | File name | | fileType | string | File type | ### **Document** | Attribute | Type | Description | | ---------------------------------- | ----------------------- | ------------------------ | | address | string | Document address | | category | string | Document category | | countryIso3 | string | Country ISO-3 code | | countryStateIso2 | string | Country state ISO-2 code | | dateOfBirth | string | Date of birth | | dateOfExpiration | string | Date of expiration | | dateOfIssue | string | Date of issue | | documentNumber | string | Document number | | [files](#document-files) | array\** | List of document files | | firstName | string | First name | | fullName | string | Full name | | gender | string | Gender | | lastName | string | Last name | | middleName | string | Middle name | | mrzVerified | boolean | MRZ verification status | | nationalityIso3 | string | Nationality ISO-3 code | | [ocrValidations](#ocr-validations) | array\ | List of OCR validations | | personalCode | string | Personal code | | type | string | Document type | ### Document Files
AttributeTypeDescription
autoCaptureConfidenceRatenumberAuto-capture confidence rate
createdUtcstringCreation date and time (UTC)
fileExtensionstringFile extension
fileIdstringFile identifier
fileNamestringFile name
fileTypestringFile type
partstringPart of the document
### Face | Attribute | Type | Description | | -------------------- | -------------- | ----------------------- | | ageEstimation | string | Age estimation | | ageEstimateGroupV2 | string | Age estimate group (V2) | | enrollmentId | string | Enrollment ID | | [files](#face-files) | array\ | List of face files | ### **Face Files** | Attribute | Type | Description | | ------------- | ------ | ---------------------------- | | createdUtc | string | Creation date and time (UTC) | | fileExtension | string | File extension | | fileId | string | File identifier | | fileName | string | File name | | fileType | string | File type | ### **Fraud Checks** | Attribute | Type | Description | | ---------------------- | -------------- | ------------------------------------ | | fileId | string | File identifier | | name | string | Fraud check name | | reasons | array\ | List of fraud check reasons | | status | string | Fraud check status (e.g., "Success") | | linkedIdentificationId | string | Linked identification identifier | ### **Proof of Address** | Attribute | Type | Description | | ---------------------------------- | -------------- | ------------------------------------------------- | | city | string | City | | files | array\ | List of proof of address files | | firstName | string | First name | | lastName | string | Last name | | [ocrValidations](#ocr-validations) | array\ | List of Optical character recognition validations | | parish | string | Parish | | street | string | Street | ### **Registries** | Attribute | Type | Description | | --------- | ------ | ----------------------- | | name | string | Registry name | | reason | string | Reason | | status | string | Status (e.g., "Ignore") | ### Rules | Attribute | Type | Description | | --------- | ------ | ------------------------ | | name | string | Rule name | | reason | string | Reason | | status | string | Status (e.g., "Success") | ### Scores | Attribute | Type | Description | | --------- | ------ | ----------- | | name | string | Score name | | value | string | Score value | ### Setup | Attribute | Type | Description | | --------- | ------ | ----------- | | id | string | Setup ID | | versionId | string | Version ID | ### OCR Validations | Attribute | Type | Description | | --------- | ------- | --------------------------------------- | | isValid | boolean | Flag indicating if validation is valid | | key | string | Name of the field that's been validated | ### Output Example ```postman_json { "state": "COMPLETED", "identityVerification": { "applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "communicationChannels": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "type": "Email" } ], "createdUtc": "2023-09-14T13:09:56.847Z", "externalReferenceId": "123", "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "modifiedUtc": "2023-09-14T13:09:56.847Z", "redaction": { "redactedUtc": "2023-09-14T13:09:56.847Z" }, "registration": { "dateOfBirth": "2021-01-14", "email": "John@email.com", "firstName": "John", "lastName": "Johnson", "middleName": "Adam", "personalCode": "1214148111000", "phoneNumber": 370624515141, "countryCode": "LT" }, "setup": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "overrideId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "versionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }, "status": "Pending", "step": { "authenticationSignature": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }, "consent": { "consentedUtc": "2021-01-02T14:08:39.712Z", "id": "01d9d9df-afb3-445c-a9cf-012012df58ea", "isConsented": false }, "documentSignatures": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" } ], "forms": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" } ], "kybIdentification": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }, "kycIdentification": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }, "faceAuthentication": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" } } }, "kycVerification": { "additionalFiles": [ { "createdUtc": "2023-09-14T13:13:15.724Z", "fileExtension": "jpeg", "fileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "fileName": "identity_file.jpeg", "fileType": "ProofOfAddress" } ], "applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "auditFiles": [ { "createdUtc": "2023-09-14T13:13:15.724Z", "fileExtension": "jpeg", "fileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "fileName": "identity_file.jpeg", "fileType": "ScreenRecording" } ], "completedUtc": "2023-09-14T13:13:15.724Z", "createdUtc": "2023-09-14T13:13:15.724Z", "document": { "address": "string", "category": "B", "countryIso3": "LTU", "countryStateIso2": "GR", "dateOfBirth": "2000-02-03", "dateOfExpiration": "2000-02-03", "dateOfIssue": "2000-02-03", "documentNumber": "PU2343443343", "files": [ { "autoCaptureConfidenceRate": 99.9, "createdUtc": "2023-09-14T13:13:15.725Z", "fileExtension": "jpeg", "fileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "fileName": "identity_file.jpeg", "fileType": "DocumentPhoto", "part": "Front" } ], "firstName": "John", "fullName": "John Adam Jones", "gender": "Male", "lastName": "Jones", "middleName": "Adam", "mrzVerified": true, "nationalityIso3": "LTU", "ocrValidations": [ { "isValid": true, "key": "Address" } ], "personalCode": "199202030202", "type": "IdCard" }, "face": { "ageEstimation": "AgeUnder13", "ageEstimateGroupV2": "AgeEstimateNotAvailable", "enrollmentId": "adfc35b9-faba-4b6f-9f7d-f33e2a83b0e6", "files": [ { "createdUtc": "2023-09-14T13:13:15.725Z", "fileExtension": "gif", "fileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "fileName": "face_file.gif", "fileType": "FaceVideo" } ] }, "fraudChecks": [ { "fileId": "52de38da842b4451bb4b18121eb4b80f", "name": "SeonIp", "reasons": [ "string" ], "status": "Success", "linkedIdentificationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" } ], "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "identityVerificationId": "1dbb6d1d-0596-4247-9b37-879e44c53ddc", "isCrossChecked": true, "proofOfAddress": { "city": "Amestris", "files": [ { "createdUtc": "2023-09-14T13:13:15.725Z", "fileExtension": "jpeg", "fileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "fileName": "identity_file.jpeg", "fileType": "DocumentPhoto" } ], "firstName": "John", "lastName": "Jones", "ocrValidations": [ { "isValid": true, "key": "FirstName" } ], "parish": "Amestria", "street": "Amestry st. 15-25" }, "registries": [ { "name": "SharedDatabase", "reason": "FoundInSanctionsList", "status": "Ignore" } ], "rules": [ { "name": "SelfieHasFace", "reason": "SelfieHasNoFace", "status": "Success" } ], "scores": [ { "name": "SelfieAndDocumentImageComparison", "value": "0" } ], "setup": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "versionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }, "status": "Awaiting", "statusReason": "MissingDocumentPhoto" }, "files": { ... } } ```