Transaction Tracking and Charging
DOT is charged for per-transactions usage. In order to allow this, the transactions performed by Digital Identity Service are tracked in logs and in an online Innovatrics server if enabled.
Reporting of Transactions
Online Reporting
Prerequisite: The Digital Identity Service deployed in production must be connected to Innovatric’s transaction collecting server via a secure connection, as described in technical documentation of DIS.
The transactions are tagged with customer’s individual API key assigned in the product license and used for the API calls.
No manual action is needed on customer’s side.
Manual Reporting for Disconnected Instances of DIS
Customer manually extracts and delivers logs stored in a specified folder of the DIS instance - see technical documentation of DIS. Customer sends all logs to Innovatrics on a quarterly basis or uploads them to the Innovatrics Customer Portal (when available).
Transaction Types Being Charged
Innovatrics is tracking and billing following transactions, each having equal price:
- OCR extraction of data from ID document including visual and MRZ zone (both sides of document count as one transaction)
- Liveness detection (Passive, MagnifEye or Smile type of liveness, each evaluation counts as one transaction)
- Face matching (face vs document or face vs face, each matching counts as one transaction)
- Face image evaluation (ICAO quality evaluation, cropping, background removal, age and gender estimation; any combination of these functions counts as one transaction)
- Document NFC readout *
- Document authenticity * (any combination of screen and print attack detection, BW photocopy detection and document data cross-check counts as one transaction)
* To be applicable when Innovatrics releases given feature
Data Security
Transaction logs do not contain any private or sensitive information about clients. Only failure statistics and data on transaction quantity and quality are collected by Innovatrics in order to optimize server configuration. These same events are also recorded in the service logs, which are fully open for customer audit. All monitored events are listed below.
Customer Onboarding API Events
| Event | API call | Parameters |
|---|---|---|
| dis-customers-new | POST /api/v1/customers | server-version |
| dis-customers-selfie | POST /api/v1/customers/{id}/selfie | server-version image-resolution result |
| dis-customers-liveness | PUT api/v1/customers/{id}/liveness | server-version |
| dis-customers-liveness-selfies | POST /api/v1/customers/{id}/liveness/selfies | server-version assertion (liveness type) image-resolution result |
| dis-customers-liveness-evaluation | POST /api/v1/customers/{id}/liveness/evaluation | server-version type (liveness type) score (rounded) result |
| dis-customers-document | PUT /api/v1/customers/{id}/document | server-version sources (type of extraction) advice (if advice type was provided) |
| dis-customers-document-pages | PUT /api/v1/customers/{id}/document/pages | server-version document-type page (front/back) recognized (level of recognition) duration image-resolution image-size-kb image-format ocr-confidence (average rounded) result |
| dis-customers-get-data | every GET operation | server-version operation (name of GET call) |
| dis-customers-get-person | GET /api/v1/customers/{id} | server-version provided-selfie (true/false) provided-document (true/false) document-face-found (true/false) |
| dis-customers-inspect | POST /api/v1/customers/{id}/inspect | server-version similarity-selfie-document (true/false) similarity-selfie-liveness (true/false) face-mask (true/false) aspect-age (difference between estimation and date of birth) aspect-gender (match between estimation and document) |
| dis-customers-document-inspect | POST /api/v1/customers/{id}/document/inspect | server-version pages (count) expired (true/false) mrz-check (true/false) text-consistency (true/false) color-profile-change-detected (true/false) looks-like-screenshot (true/false) |
| dis-customers-store | POST /api/v1/customers/{id}/store | server-version status |
| dis-metadata-get | GET /api/v1/metadata | server-version |
| dis-customers-delete | DELETE /api/v1/customers/{id} | server-version |
| dis-customers-selfie-delete | DELETE /api/v1/customers/{id}/selfie | server-version |
| dis-customers-liveness-delete | DELETE api/v1/customers/{id}/liveness | server-version |
| dis-customers-document-delete | DELETE /api/v1/customers/{id}/document | server-version |
Mapping the Charged Transactions to the API Events
OCR Extraction
Counted each time the DIS API call GET /api/v1/customers/{id} is called, where at least one page of document was uploaded for that customer entity
Liveness Detection
Counted each time the DIS API call POST /api/v1/customers/{id}/liveness/evaluation is called, no matter how many face images were provided for that liveness evaluation.
Face Matching
Counted each time any of the following two DIS API calls is called POST /api/v1/customers/{id}/inspect or POST /api/v1/faces/{probe_face_id}/similarity. The customers/inspect is matching the face between document and selfie. The similarity is matching any pair of faces provided.
Face Evaluation
Counted in following occasions:
- Each time the DIS API call
GET /api/v1/customers/{id}is called, where for that customer entity is a face uploaded and there is no document page loaded. - Each time the DIS API call
GET /api/v1/faces/{id}/aspectsis called - Each time the DIS API call
GET /api/v1/faces/{id}/cropis called
Document Authenticity Check
- Counted each time the DIS API call
POST /api/v1/customers/{id}/document/inspectis called.