0% found this document useful (0 votes)

47 views48 pages

Digio API for ID Card Verification

The document provides a comprehensive guide to the Digio Stateless Cloud SaaS API, detailing the various environments (Sandbox and Production), API endpoints for ID card verification, and the required parameters for making requests. It includes specific APIs for verifying Indian ID cards, such as PAN, Aadhaar, Voter ID, and Driving License, along with sample success responses. Additionally, it emphasizes that Digio reserves the right to modify the API document and will notify businesses of any changes in advance.

Uploaded by

valayan2022

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

0% found this document useful (0 votes)

47 views48 pages

Digio API for ID Card Verification

Uploaded by

valayan2022

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

Getting started with Digio Stateless Cloud SaaS API

Getting started with Digio Stateless Cloud SaaS API 1

Digio Environments: Sandbox & Production 1

Indian Individuals (ID Cards | OCR and Verification) 2

Indian Individuals (ID Cards | Verification) 10

Aadhaar Masking API 14

Business Entity’s Verification 16

Face Match API 22

OCR API (Other than ID Cards) 23

UPI VPA Verification 24

Bank Account Verification (Penny Drop) 25

Fuzzy Match 31

Aadhaar Offline XML KYC (Native app Android) 32

Android SDK with and without Machine Learning (Native app) 37

Digio Environments: Sandbox & Production

Environment BASE URL API Credentials

Sandbox [Link] Use Sandbox client id/client secret

Production [Link] Use Production client id/client secret

Below List of URLs and IP addresses need to be whitelisted, if required by

a business in the Firewall

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

1
URLs (For outgoing traffic):

Sandbox : [Link]
Production : [Link]

Indian Individuals (ID Cards | OCR and Verification)

Digio Indian ID card Analysis and Verification APIs can be used for extracting data and user image
from below types of ID cards and verifying with the central database.

1. PAN
2. VOTER_ID
3. AADHAAR
4. PASSPORT
5. DRIVING LICENSE
6. Registration Certificate (RC of vehicle registration)

POST {BASE_URL}/v3/client/kyc/analyze/file/idcard

Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “multipart/form-data”

Param Name Param Type Is Mandatory Description

front_part File Yes Front Part of ID Card

back_part File No Back Part of ID card

unique_request_id String No Unique request id for logging purpose

should_verify Boolean No Send true if analysed OCR output to be

verified against central DB

AaaaaaDenotes : Central Database Match Result

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

2
Success Response : PAN

{
"name": "AMIT SONTHALIA",

"fathers_name": "Father’s Name as per PAN COPY",

"id_no": "XXXXXXXXXX821M",

"dob": "dd/mm/yyyy",

"id_type": "PAN",

"encoded_signature": "base64 of cropped signature",

"encoded_image": "base64 of photograph on PAN Card",

"pan_verification_response": {

"is_pan_dob_valid": true,

"name_matched": true

"id_card_verification_response": {

"verified": true

Success Response : Aadhaar

"name": "Amit SanthalaS",

"id_no": "xxxxxxxx4042", [Complete Aadhaar no, please mask it before storing in

Database]

"dob": "12/01/1960",

"address": "\n\nWIO: Shiv Charan Gupta,\n6/MB/334, Indira Gandhi

Nagar,\nJagatpura, Dantli, Jaipur,\nRajasthan - 303012",

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

3
"gender": "Female",

"id_type": "AADHAAR",

"encoded_image": "base64 of photograph on Aadhaar Card",

"address_information": {

"address": "WIO: Shiv Charan Gupta, 6/MB/334, Indira Gandhi Nagar, Jagatpura,
Dantli, Jaipur, Rajasthan - 303012",

"locality_or_post_office": "Dantli",

"district_or_city": "Jaipur",

"state": "Rajasthan",

"pincode": "303012"

Success Response : Voter ID

"name": "Amit Sonthalia",

"mothers_name": " : Sarita Sonthalia",

"id_no": "xxxxxx8047",

"address": "Complete Address as per ID Card uploaded",

"id_type": "VOTER_ID",

"date_of_issue": "13/02/2009",

"encoded_image": "base64 of photograph on VOTER ID",

"address_information": {

"address": Complete Address as per ID Card uploaded",

"locality_or_post_office": "",

"district_or_city": ""

"id_card_verification_response": {

"verified": true,

"result": {

"id_no": true,

"name": true

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

4
},

"id_data": {

"pc_name": "NORTH WEST DELHI ",

"st_code": "U05",

"ps_lat_long_1_coordinate": 0,

"gender": "M",

"rln_name_v2": "",

सतीश
"rln_name_v1": " कुमार ",

"rln_name_v3": "",

"name_v1": "अरश व
ु बघेल ",

"ac_name": "ROHINI",

"name_v2": "",

"name_v3": "",

"ps_lat_long": "0.0,0.0",

"pc_no": "5",

"last_update": "Tue Feb 11 20:36:31 IST 2020",

"id": "U050130022050825",

"dist_no": "8",

"ps_no": "22",

"ps_name": "NORTH DMC PRY. SCHOOL NO-2 SEC 18 ROHINI (NEAR DR. LAL PATH
LAB)",

नॉथ डी एम सी
"ps_name_v1": " ाइमर कूल\t नं -2 से टर-18 रो हणी ( नकट डॉ टर लाल
पाथ लैब।) द ल ",

"st_name": "NCT OF Delhi",

"dist_name": "NORTH ",

"rln_type": "F",

उ र पि चमी द ल ",
"pc_name_v1": "

रोहणी सै टर 18",
"part_name_v1": "

रो हणी",
"ac_name_v1": "

"part_no": "22",

उ र",
"dist_name_v1": "

"ps_lat_long_0_coordinate": 0,

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

5
"_version_": 1658268958771380226,

"name": "ARSH DHRUV BAGHEL ",

"section_no": "5",

"ac_no": "13",

"slno_inpart": "825",

"rln_name": "SATISH KUMAR ",

"age": 24,

"part_name": "SECTOR-18 ROHINI",

"id_no": "AFQ2053295 "

Success Response : Passport

"name": "INDIAN",

"fathers_name": "",

"mothers_name": "",

"id_no": "",

"dob": "",

"address": "",

"gender": "",

"id_type": "PASSPORT",

"file_no": "",

"type": "",

"country_code": "",

"sur_name": "",

"nationality": "",

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

6
"place_of_birth": "",

"place_of_issue": "",

"encoded_image": "base 64 of photograph on Passport",

"address_information": {

"locality_or_post_office": "SAGAR NAGAR",

"district_or_city": "VISAKHAPATNAM URBAN",

"state": "ANDHRA PRADESH",

"pincode": "530045"

Success Response : Driving License

"name": ": AKASH KUMAR",

"id_no": "BR-0320140060327",

"dob": "02-01-1994",

"id_type": "DRIVING_LICENSE",

"encoded_image": "",

"id_card_verification_response": {

"verified": true,

"result": {},

"id_data": {

"Date Of Issue": "20-Jun-2014",

"NT": "MCWG",

"Old / New DL No.": "NA",

"Holder's Name": "AKASH KUMAR",

"Hazardous Valid Till": "NA",

"Non-Transport": "From: 20-Jun-2014",

"Transport": "From: NA",

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

7
"Current Status": "ACTIVE",

"Last Transaction At": "DTO, BHOJPUR"

Success Response : Registration Certificate

"id_no": "KA06ES4811",

"id_type": "VEHICLE_RC",

"engine_no": " U5S5FOEK079936",

"chassis_no": " ME3U5S5FOEK079936",

"id_card_verification_response": {

"verified": true,

"result": {

"id_no": true

"id_data": {

"Fuel Norms": "NOT AVAILABLE",

"id_no": "KA06ES4811",

"Maker / Model": "ROYAL-ENFIELD (UNIT OF EICHER LTD) / ENFIELD CLASSIC

500",

"Chassis No": "ME3U5S5F0EK0XXXXX",

"Fitness Upto": "22-Dec-2029",

"Owner Name": "ARVIND SENCHA",

"Vehicle Class": "M-CYCLE/SCOOTER (2WN)"

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

8
Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

9
Indian Individuals (ID Cards | Verification)
Digio Indian ID card Verification APIs can be used for below types of ID cards and verifying them
with the central database.

POST {BASE_URL}/v3/client/kyc/fetch_id_data/{id_card_type}

Please pass id type from the list mentioned below in {id_card_type}

1. VOTER_ID
2. DRIVING_LICENSE
3. VEHICLE_RC

Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “application/json”

Request:

Param Name Param Type Is Mandatory Description

id_no String Yes

dob String Yes Date of Birth, Mandatory for DL

and not for VoterId and RC
dd/mm/yyyy format

Response: Map of Id card properties to value from central database'

VOTER_IDRequest:
{
"id_no" :"AFQ2053295"
}

Response:
{
"pc_name": "NORTH WEST DELHI ",
"st_code": "U05",

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

11
}

DRIVING LICENSE Request:

{
"id_no" :"DL Number",
"dob" :"30/12/1996"
}

Response:
{
"Date Of Issue": "11-Dec-2015",
"NT": "LMV",
"Old / New DL No.": "NA",
"Holder's Name": "Holder Name",
"Hazardous Valid Till": "NA",
"Non-Transport": "From: 11-Dec-2015",
"Transport": "From: NA",
"Current Status": "ACTIVE",
"Last Transaction At": "RTO, SALEM SOUTH"
}

VEHICLE_RCRequest:
{
"id_no" :"Vehicle registration number without space"
}

Response:
{
"Fuel Norms": "NOT AVAILABLE",
"Registration No": "",
"Maker / Model": "ROYAL-ENFIELD",
"Chassis No": "ME3U5S5F0EK0XXXXX",
"Fitness Upto": "22-Dec-2029",
"Owner Name": "",
"Vehicle Class": "M-CYCLE/SCOOTER (2WN)"
}

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

12
4. PAN

POST {BASE_URL}/v3/client/kyc/pan/verify

Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “application/json”

Request:

Param Name Param Type Is Mandatory Description

pan_no String Yes

date_of_birth String Yes Date of Birth, Mandatory

yyyy-mm-dd format

full_name String Yes

Request:
{
"pan_no" : "ABCDE1234A",
"full_name" : "Dinesh Rathore",
"date_of_birth" : "1990-07-05"
}

Response:
{
"is_pan_dob_valid": true,
"name_matched": true
}

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

13
Aadhaar Masking API
Approach 1 : Upload the file

POST v3/client/kyc/aadhaar/file/mask

Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “multipart/form-data”

Request Body

Param Name Param Type Is Mandatory Description

file File yes Aadhaar image file in JPEG/JPG/PNG or PDF

format

consent String yes “yes/no”. Positive consent is mandatory to

perform this action.

file_name String no Response file name if it has to be a specific one.

Output given will always be in “.png”

unique_request_id String no Any unique request id for audit purpose

Approach 2 : Upload encoded base64

POST v3/client/kyc/aadhaar/mask

Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “application/json”

Param Name Param Type Is Mandatory Description

data String yes Base64 encoded Aadhaar image file in JPEG/JPG or

PNG format. If you want to use PDF pass another
attribute “data_content_type”:”PDF”

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

14
consent String yes yes/no

file_name String no Response file name if it has to be a specific one.

Always given with .png

unique_request_id String No Unique request id for logging purpose

Response:

Masked Aadhaar image stream of image/png type

If response is required in json format (Base64 encoded image) pass ?resp_json=true as query param. Image is
returned as a “data” attribute inside json.

Please Note: Try to keep the file size as small as possible for faster results and not more than 1 MB as a good
practice.

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

15
Business Entity’s Verification
Business 360 Degree verification. APIs can be used for extracting data from central databases and
matching it against data in your repository:

1. FSSAI License
2. Udyog AADHAAR
3. Company information
4. Director Information
5. GST Number

POST {BASE_URL}/v3/client/kyc/fetch_id_data/{type}

Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “application/json”

Request:

Param Name Param Type Is Mandatory Description

id_no String Yes Check below table for more

details

Business Id Type Type Enum Mandatory Param (what to pass in id_no)

FSSAI License FSSAI FSSAI License Number

Udyog AADHAAR UAADHAAR Udyog Aadhar Registration Number

Company information CIN CIN number of a company, Other Option is to pass

name of company in param “name”

Director Information DIN DIN Number of person

GSTIN GST GSTIN number

1. Success Response : FSSAI

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

16
{
"Status": "Active",
"Company Name": "RUCHI SOYA INDUSTRIES LIMITED",
"Products": "02 - FATS AND OILS, AND FAT EMULSION, 03 - EDIBLE ICES, INCLUDING SHERBET
AND SORBE, 04 - FRUITS AND VEGETABLES (INCLUDING MUSHROOMS AND FUNGI, ROOTS AND
TUBERS, PULSES AND LEGUMES, AND ALOE VERA), SEAWEEDS, AND NUTS AND SEEDS, 05 –
CONFECTIONERY, 06 - CEREALS AND CEREAL PRODUCTS, DERIVED FROM CEREAL GRAINS, FROM
ROOTS AND TUBERS, PULSES, LEGUMES AND PITH OR SOFT CORE OF PALM TREE, EXCLUDING
BAKERY WARES OF FOOD CATEGORY 7.0, 07 - BAKERY PRODUCTS, 11 - SWEETENERS, INCLUDING
HONEY, 12 - SALTS, SPICES, SOUPS, SAUCES, SALADS AND PROTEIN PRODUCTS, 14 - BEVERAGES,
EXCLUDING DAIRY PRODUCTS, 15 - READY-TO-EAT SAVOURIES",
"Kind of Business": "Storage (Cold / Refrigerated), Storage (Except Controlled Atmosphere and
Cold), Wholesaler",
"Expiry Date": "08/07/2021",
"Premises Address": "Ruchi Soya Industries Limited C/O M/S Surender Logistics Survey No. 78/2/1,
building no.B-6, Gala no.9,10,11, At post Gundavali, Tal. Bhiwandi, Dist Thane: 412302, District -
Thane, STATE - Maharashtra",
"License / Registration No.": "10012022000259"
}

2. Success Response : UAADHAR

{
"Code of Enterprise": "B",
"UAN": "_____",
"Name of Enterprise": "_____",
"Major Activity": "Manufacturing",
"Social Category": "General",
"Location of Plant Details": [
{
"Flat/Door/Block No.": "_____",
"Name of Premises/Building Village": "_____",
"Road/Street/ Lane": "_____",
"Area/Locality": "_____",
"City": "BENGALURU",
"Pin": "562130",
"State": "KARNATAKA",
"District": "BENGALURU (URBAN)"
}
],
"Enterprise Type": "Small",
"National Industry Classification Code": [
{
"NIC 2 Digit": "27-Manufacture of electrical equipment",
"NIC 4 Digit": "2750-Manufacture of domestic appliances",
"NIC 5 Digit Code": "27509-Manufacture of other domestic appliances n.e.c.",
"Activity Type": "Manufacturing",
"Added On": "06/09/2017"
},
{
"NIC 2 Digit": "27-Manufacture of electrical equipment",
"NIC 4 Digit": "2750-Manufacture of domestic appliances",

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

3. Success Response : CIN

{
"CIN ": "_____",
"Company Name": "_____",
"ROC Code": "RoC-Bangalore",
"Registration Number": "_____",
"Company Category": "Company limited by Shares",
"Company SubCategory": "Non-govt company",
"Class of Company": "Private",
"Authorised Capital(Rs)": "_____",
"Paid up Capital(Rs)": "_____",
"Number of Members(Applicable in case of company without Share Capital)": "0",
"Date of Incorporation": "12/04/2016",
"Registered Address": "_____",
"Address other than R/o where all or any books of account and papers are maintained": "-",
"Email Id": "_____",
"Whether Listed or not": "Unlisted",
"ACTIVE compliance": "ACTIVE compliant",
"Suspended at stock exchange": "-",
"Date of last AGM": "30/09/2019",
"Date of Balance Sheet": "31/03/2019",
"Company Status(for efiling)": "Active",
"directors": [
{
"End date": "-",
"Begin date": "12/04/2016",
"DIN/PAN": "_____",
"Surrendered DIN": "",
"Name": "_____"
},
{
"End date": "-",
"Begin date": "12/04/2016",
"DIN/PAN": "_____",
"Surrendered DIN": "",
"Name": "A_____"
}

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

18
]
}

4. Success Response : DIN

{
"DIN": "_____",
"Name": "SANKET NAYAK",
"companies": [
{
"CIN/FCRN": "_____",
"Company Name": "_____",
"Begin Date": "12/04/2016",
"End Date": "-",
"ACTIVE compliance": "ACTIVE compliant"
}
],
"llps": []
}

5. Success Response : GST

{
"gstin": "123456789123456",
"corporate_name": "Dummy Corporate Private Limited",
"details": {
"stj_cd": "KA012",
"dty": "Regular",
"lgnm": "Dummy Corporate Private Limited",
"adadr": [

],
"cxdt": "",
"gstin": "123456789123456",
"nba": [
"Supplier of Services"
],
"lstupdt": "15\/02\/2019",
"ctb": "Private Limited Company",
"rgdt": "27\/10\/2017",
"pradr": {
"addr": {
"bnm": "",
"loc": "Koramangala",
"st": "15th Cross Rd.",
"bno": "No. 45",
"dst": "Bengaluru (Bangalore) Urban",

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Failure Response :
{
"gstin": "123456789123456",
"error_message": "Invalid GSTIN \/ UID"
}

6. Corporate Pan

POST {BASE_URL}/v3/client/kyc/pan/verify

Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “application/json”

Request:

Param Name Param Type Is Mandatory Description

pan_no String Yes

date_of_birth String Yes Date of Incorporation, Mandatory

dd/mm/yyyy format

full_name String Yes

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

20
Response:

{
"is_pan_dob_valid": true,
"name_matched": true
}

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

21
KRA Registry APIs
These apis can be used to check status, fetch details from KRA and submit details to KRA.
Note: These services are available by getting your KRA credentials configured in Digio Systems.
Currently we support NDML and CVL KRA Agencies.

Check Pan Status

POST {BASE_URL}/v3/client/kyc/kra/get_pan_details
Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “application/json”

Request:

Param Name Param Type Is Mandatory Description

pan_no String Yes

dob String Yes In DD/MM/YYYY format.

List of status in Response

Not Checked with respective KRA

Submitted
KRA Verified
Hold
Rejected
Not available
Deactivated
Existing KYC Submitted
Existing KYC Verified
Existing KYC hold
Existing KYC Rejected
KYC REGISTERED WITH CVLMF
Not Checked with Multiple KRA
Invalid PAN NO Format

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

22
Sample Request:
{
"pan_no": "PAN Number",
"dob": "05/07/1990"
}

Sample Response:
{
"result": "FOUND",
"pan_number": "PAN Number",
"name": "Name",
"status": "KRA Verified",
"status_date": "29-04-2017 16:16:45",
"entry_date": "12-04-2017 12:30:16",
"modification_date": "",
"kyc_mode": "Normal KYC",
"deactivate_remarks": "",
"update_remarks": "",
"ipv_flag": "Y",
"pan_details": {
"pan_number": "PAN",
"dob": "05/07/1990",
"gender": "M",
"name": "name",
"father_name": "fathers name",
"correspondence_address1": "",
"correspondence_address2": "",
"correspondence_address3": "JAITARAN",
"correspondence_city": "PALI",
"correspondence_pincode": "306302",
"correspondence_state": "Rajasthan",
"correspondence_country": "India",
"correspondence_address_proof": "Id Type",
"correspondence_address_proof_ref": "Id Number",
"correspondence_address_proof_date": "",
"mobile_number": "",
"email_address": "",
"permanent_address1": "",
"permanent_address2": "",
"permanent_address3": "JAITARAN",
"permanent_city": "PALI",
"permanent_pincode": "306302",
"permanent_state": "Rajasthan",
"permanent_country": "India",
"permanent_address_proof": "Id type",
"permanent_address_proof_ref": "Id Number",
"permanent_address_proof_date": "",
"income": "> 25 LAC",
"occupation": "PRIVATE SECTOR SERVICE",
"political_connection": "NA",
"resident_status": "R",
"nationality": "Indian",

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

23
"ipv_date": "29/03/2017"
}

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

24
Face Match API
Face Matching APIs can be used matching two images either between id cards or between a selfie
(photograph) or image extracted from the frames of a video.

POST {BASE_URL}/v3/client/kyc/facematch

Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “ Multipart/Form-data”

Param Name Param Type Is Mandatory Description

file1 File Yes File type has to be image (supported

types are .jpg, .png,

file2 File Yes File type has to be image (supported

types are .jpg, .png,

minimum_match Integer No If you don't pass the param, then by

default system will take 75 % as
minimum match

unique_request_id String no Any unique request id for audit

purpose

Response
{
"match_result": "matched",
"confidence": "90%",
}

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

25
OCR API (Other than ID Cards)
This is a plain api which gives a string of readable text on any image.

POST {BASE_URL}/v3/client/kyc/image/perform_ocr

Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “Application/json”

Param Name Param Type Is Mandatory Description

front_part String Yes Base64 Encoded Image

unique_request_id String No Unique request id for logging

purpose

Response
String containing OCR data

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

26
UPI VPA Verification
This APi can be used to find customer names against VPA and verify status of same.

POST {BASE_URL}/v3/client/public/upi/check_vpa

Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “application/json”

Request

{
"virtual_address" : "abc@ybl"
}

Response

{
"virtual_address" : "abc@ybl"
"customer_name" : "Customer Name",
"status" : "AVAILABLE/NOT_AVAILABLE/FAILED",
"status_description" : "description"
}

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

27
Bank Account Verification (Penny Drop)
Bank Account Verification APIs can be used to verify the bank account number provided by an
individual or a business. It runs on IMPS platform powered by National Payment Corporation of
India (NPCI)

POST {BASE_URL}/client/verify/bank_account

Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “application/json”

Use Case : Default, Re 1. Credit to customers bank account

Request

{
"beneficiary_account_no" : "123110023204445",
"beneficiary_ifsc": "UTIB0000888"
}

Use Case : Custom, Re 1 + any amount of corporate choice (max upto Rs. 2), credit to
customers bank account

Request

{
"beneficiary_account_no" : "123110023204445",
"beneficiary_ifsc": "UTIB0000888",
"amount": "1.20",
}

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

28
Response Success
{
"id": "FTI1901091725336218AA5CB1LMWHM1E",
"verified": true,
"verified_at": "2019-01-09 17:25:39",
"beneficiary_name_with_bank": "DUMMY CUSTOMER NAME"
}

Please note : In a sandbox environment you will get “DUMMY CUSTOMER NAME” always as a hardcoded value.
In production you will get the actual name of the beneficiary associated with the account uptol 20 characters.

Response Failure
{
"id": "R9SGBH61RO3L15Q",
"verified": false,
"error_msg": "Invalid beneficiary account details"
}

Response Failure
{
"id": "FTI1809111232556634TGAOUXJM5LLUY",
"verified": false,
"error_code": "es405",
"error_message": "Some error message"
}

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

29
List of error codes & messages
Note: Please consider the highlighted error codes and error messages for key reasons

statusCode subStatusCo Meaning When Does it Recommended Error

de (error message) Come? Action type
(error code)

FAILED ns:E402 Insufficient Balance in When account to Fund the debit

debit account, be debited account and retry,
payment required doesn't have contact DIGIO :
sufficient funds support@[Link]

FAILED ns:E405 Invalid Transfer Type The Transaction Retry the transaction Business
Type is not from with a valid
the list specified transferType or with
ANY

FAILED ns:E429 (Limit Number of Retry next day Business

Daily/transaction/rate) requests that
exceeded have come from
you have
exceeded the
permissible limit
set by an
upstream
system

FAILED ns:E406 Beneficiary not Problem with check with Business

acceptable beneficiary beneficiary bank
account

IN_PROCESS Transaction Check status after 30 Technical

timed out during minutes and retry if
execution FAILED

FAILED ns:E502 Bad Gateway An upstream Contact Support Technical

service returned
an unexpected
error

FAILED ns:E1001 The transaction Transaction Check Internally Business

amount exceeds the Amount exceeds
maximum amount for IMPS Maximum
IMPS Limit

FAILED ns:E1002 The transfer currency Transfer Pass 'INR' in transfer Business
is not supported. Currency is currency and
Supported currency is other than 'INR'

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

30
INR

FAILED ns:E1003 The transaction Transfer Amount Retry after correcting Business
amount should be is in fraction. the transfer amount
multiples of Re 1 for
RTGS

FAILED ns:E1004 Transfer Amount is Transaction Check transfer type Business

less than the minimum Amount is less and amount and retry
amount for RTGS than RTGS
Minimum
amount

FAILED ns:E6000 Purpose Code not Purpose Code Check Internally Business
found passed in the
request does not
exist in system

FAILED ns:E6001 Only registered Check Check Internally Business

beneficiaries are beneficiary code
allowed for this if registered and
purpose code retry

FAILED ns:E6002 Purpose Code is Pass purpose Check Internally Business

required for this code
customer

FAILED ns:E8000 A transaction with the UniqueRequest Retry with a new Technical
same reference No has already UNR
number is already come before for
processed or under a successful
processing transaction

FAILED ns:E6003 Invalid Debit Account When debit Contact Support Business
for Customer account no does
not exist in the
customer set up

FAILED flex:E18 Hold Funds Present - Account is in hold Business

Refer to Drawer ( status. Contact
Account would Support.
Overdraw )

FAILED flex:E404 No Relationship Exists Contact Support Technical

with the debit Account
{AccountNo} and
partner

FAILED flex:E8036 NEFT - Both Customer Issue with Remitter Technical

Mobile and Email is Account setup.
Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

31
not valid. Contact support

FAILED flex:E8087 To Account Number is Retry with correct Business

Invalid Beneficiary/customer
Account

FAILED flex:E9072 Invalid IFSC Code Retry with correct Business

beneficiary IFSC
Code

FAILED npci:E08 Acquiring Bank CBS or Beneficiary bank Technical

node offline node offline. Retry
later

SENT_TO_B IMPS: IMPS: Check status

ENEFICIARY Transaction after 1 hour.
accepted by Transaction status
NPCI but no expected to clear to
response COMPLETED/FAILE
received from D after 2 working
beneficiary bank days in most cases.
within the time NEFT: Check status
limit set NEFT: after 3 hours in NEFT
Transaction has working window.
been accepted
by RBI but the
acknowledgeme
nt has not yet
been received

FAILED npci:EM1 Invalid Beneficiary Retry with correct Business

MMID/Mobile Number MMID/Mobile
Number

FAILED npci:EM2 Amount limit exceeded Transaction Retry with Transfer Business
Amount exceeds Type NEFT or ANY
IMPS Maximum
Limit

FAILED npci:EM3 Account Contact Support. Business

blocked/frozen

FAILED npci:EM4 Beneficiary Bank is not Beneficiary account Business

enabled for Foreign is an NRE Account.
Inward Remittance Domestic
Transactions not
permitted. This will
not come for Inward
Remittance Via

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

32
RDA/MTSS

FAILED npci:EM5 Account closed Beneficiary account Business

is closed.

FAILED atom:E404 No Relationship Exists Contact Support Technical

with the debit Account
{AccountNo} and
partner

SCHEDULED This will come Check status on next

_FOR_NEXT_ for NEFT when working day
WORKDAY the transaction
has been
received post cut
off time or on a
holiday

RETURNED_ sfms:E62 Transaction Give back money Business

FROM_BENE accepted by RBI
FICIARY but beneficiary
bank rejected it.

FAILED sfms:E99 Manually Marked in Transaction is in Give back money Business

Error error due to
issue with the
transaction
details.

FAILED sfms:E70 Outward Transaction Give back money Business

Rejected

FAILED sfms:E18 Rejected by SFMS Transaction is Give back money Business

not accepted by
the payment
body.

COMPLETED R000 Remittance

transactions has
been
successfully
processed

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Copyright © 2019-20 | [Link] | For Limited Circulation

33
Fuzzy Match
POST {BASE_URL}/v3/client/kyc/fuzzy_match

Headers:
authorization: “Basic Base64encodedValueOf(client_id:client_secret)”
content-type : “application/json”

Sample Request (For Matching Name)

{

"context":"Name",

"source":{

"text": "Dinesh Rathore"

"target":{

"text": "Rathor Danish"

"confidence": 75 [default value: 75]

Sample Request (For Matching Addresses)

{

"context":"Address",

"source":{

"text": "Vattappilly house, chettupuzha po, thrissur, 680612"

"target":{

"text": "Vattapily house, manakkodi po, thrissur, kerala, 680612"

"confidence": 75 [default value: 75]

Success Response :
{
"matched": true,

"match_score": 86.0}

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

34
Aadhaar Offline XML KYC (Native app Android)
Prerequisite

● Download Android KYC SDK (supports androidx) by clicking this icon

● Download Android KYC SDK (supports appcompat) by clicking this icon

Note: This is the last version for appcompat. Migrate app to Androidx for future updates
● Add Digio Android KYC SDK .aar file to your project as follows:

1. In Android Studio, click on File>New Module.

2. Click Import .JAR/.AAR Package then click Next.
3. Enter the location of the AAR file and click Finish.
4. Make sure the library is listed at the top of [Link] file
include ':app', ':digio-kyc-{current version}'
5. Open the app’s [Link] file and add the following line
implementation project(":digio-kyc-{current version}") to the applications list of dependencies.

*Please note that {current version} will be reflected in the .aar file which is downloaded. For eg. digio-kyc-1.1.0

In manifest add :
<activity
android:name="[Link]"
android:configChanges="keyboard|keyboardHidden|orientation|screenSize">
</activity>

Dependencies:

// Default
implementation "[Link]:core-ktx:1.3.1"
implementation '[Link]:appcompat:1.2.0'
implementation '[Link]:constraintlayout:1.1.3'
implementation '[Link]:material:1.0.0'

// Mandatory
implementation("[Link].okhttp3:okhttp:4.5.0")
implementation '[Link].retrofit2:converter-gson:2.5.0'

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

35
In [Link] (Module:app)
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
t argetCompatibility JavaVersion.VERSION_1_8
}
}

Invoke signing by following below steps :

1 - Initialize DigioConfig object.

DigioKycConfig config = new DigioKycConfig();

[Link](DigioEnvironment.SANDBOX); // Required

[Link]([Link].Your_color); // optional enable button color

[Link]([Link].your_color) ; // optional disable button color

2 Initialize DigioSesison object..

DigioNativeSession nsession = new DigioNativeSession();

3 - Call [Link] with caller Activity and pass digioKycConfig object.

// clientID and clientSecret key required

,"clientSecret");
[Link]([Link],config,"clientid"
[Link]();

//alternatively you can use below startSession method for billing reconciliation
//[Link](“referenceId”, “uniqueTxnIdentifier”, null);
//Make sure, uniqueTxnIdentifier is unique across all the transactions. Otherwise
you’ll get an error.

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

36
4 - Implement onDigioNativeKycSuccess, onDigioNativeEventTracker and onDigioNativeKycFailure function
in your caller activity. Below are function signatures :

public void onDigioNativeKycSuccess(JSONObject data){}

public void onDigioNativeKycFailure(JSONObject response) {}

public void onDigioNativeEventTracker(JSONObject eventObj){}

DigioEnvironment SANDBOX
PRODUCTION

TIP: Sample code

try {

DigioKycConfig config = new DigioKycConfig();

[Link](DigioEnvironment.SANDBOX);

[Link](Color.parseColor("#17c39b"));
[Link](Color.parseColor( "#B4E9D8"));

DigioNativeSession session = new DigioNativeSession();

[Link](MainActivity.this,config,"clientID","clientSecret");
[Link]();
} catch(Exception e) {

Sample JSONObject for onDigioNativeKycSuccess:

{
"personal_information": {
"date_of_birth": "21-08-1881",
"mobile_hash": "5eb9b114e9d8ee18e0df48724a6d6cbbf982aa822bd224924227aeef482014b0",
"email_hash": "5cc8265b2c2081761ad85e3d1c2632eb79ca6c1433a536be5052d42cd7277ccb",
"gender": "M",
"name": "John Sena"
},

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Sample JSONObject for onDigioNativeKycFailure:

{
"code": 1002,
"message": "KYC Failure",
}

Possible error codes and reason:

Error Code Details

-1000 User Cancellation before KYC is complete.

1001 Successful KYC.

1002 KYC Failed.

1004 Network Issues. Will be thrown if UIDAI’s webpage is down.

1005 User exceed OTP attempts on KYC page.

10012 User’s mobile number is not linked with Aadhaar

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

38
10015 Technical Exception from UIDAI

10016 UIDAI server error. Please try again in some time.

Proguard:
-keep class [Link] { public void onDigioNative*(...);}
//where [Link] should be the classpath to the activity where you have
put the callback functions

Android SDK with and without Machine Learning

(Native app)
How to Integrate?

1. Download Android KYC SDK (supports androidx) by clicking this icon

2. Add Digio Android KYC SDK .aar file to your project as follows:
3. In Android Studio, click on File -->New Module.
4. Click Import .JAR/.AAR Package then click Next.
5. Enter the location of the AAR file and click Finish.
6. Make sure the library is listed at the top of [Link] file
include ':app', ':digio-kyc-{current version}'
7. Open the app’s [Link](Module: app) file and add the following line
implementation project(":digio-kyc-{current version}") to the applications list of dependencies.

*Please note that {current version} will be reflected in the .aar file which is downloaded. For eg.
digio-kyc-2.1.2
*Digio SDK supports android version 5.0 and above (SDK level 21 above)

Steps to invoke

1 - Create a DigioTaskRequest List to assign task

ArrayList<DigioTaskRequest> digioTaskList = new ArrayList<>();

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

39
2- Create a DigioIDCardType List to assign ID card type

ArrayList<DigioIDCardType> idCardList = new ArrayList<>();

3- Initialize DigioTaskRequest

DigioTaskRequest idCardRequest = new DigioTaskRequest();

[Link](true); // enable for face match from id_card and selfie
[Link](60); // pass minimum face match percentage ( default 60)
[Link](false); // true for front and back side of document / false only for front side
[Link](false); // enable to validate with government database
idCardRequest.setEnableFaceDetection(false); //Make it true to enable AI base face detection feature
/** setTaskType Mandatory **/
[Link](DigioTaskType.ID_ANALYSIS); // O FFLINE_KYC / I D_ANALYSIS / SELFIE
Note: Set Task type according to business requirements.

4- Add Id Card Type and idCardRequest in List

/ Assign particular ID Type /

[Link](DigioIDCardType.PAN); // PAN / PASSPORT / VOTER I D / DRIVING_LICENCE /** optional **/
// Default SDK accepts all mentioned IDs card

/* Set allowed id card list in object */

[Link](idCardList); /** optional add pass IDTypeList in object **/

/ Assign DigioTaskRequest in list/

[Link](idCardRequest); // Finally, Add Your request in digioTaskList

5- Initialize DigioConfigObject

DigioKycConfig config = new DigioKycConfig();

[Link](DigioEnvironment.SANDBOX) ; // Required

[Link]([Link].your_color) ; // optional enable button color

[Link]([Link].your_color) ; // optional disable button color

6- Initialize DigioStateLessSession

DigioStateLessSession digioStateLessSession = new DigioStateLessSession();

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

40
7- Call [Link] and pass digioKycConfig object.

// clientID and clientSecret key required

[Link]([Link],config,"clientID","clientSecret");

/ pass list of digioTaskList in session /

digioStateLessSession.startStateLessSession(digioTaskList, this); // here this refers callback listener

/** alternatively you can use below startStateLessSession method for billing reconciliation **/

//digioStateLessSession.startStateLessSession(digioTaskList,"referenceId","uniqueRequestId", this);

/ /Make sure, uniqueRequestId is unique across all the transactions. Otherwise, you’ll get an error.

8- Implement DigioResponseListener and import onDigioResponseSuccess, onDigioResponseFailure

and onDigioEventTracker override function in your activity / fragment. Below are function signatures :

public void onDigioResponseSuccess(List<DigioTaskResponse> successResponseList){}

public void onDigioResponseFailure(List<DigioTaskResponse> failureResponseList) {}
public void onDigioEventTracker(JSONObject eventTracker){}

DigioEnvironment SANDBOX Mandatory

PRODUCTION

DigioTaskType OFFLINE_KYC DigioTaskType is a mandatory

ID_ANALYSIS option.
SELFIE

DigioIDCardType PAN Note: DigioIDCardType is optional if

PASSPORT a business requires a particular ID
VOTER_ID then pass ID card type. SDK will
DRIVING_LICENCE validate for the required ID Card.
Default SDK can accept anyone
from the above list.

Permissions

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

41
/** Mandatory **/
<uses-permission android:name="[Link]" />
<uses-permission android:name="[Link].ACCESS_NETWORK_STATE" />

/ Required for ID card analysis, selfie and face match/

<uses-permission android:name="[Link]" />
<uses-permission android:name="[Link].READ_EXTERNAL_STORAGE" />
<uses-permission android:name="[Link].WRITE_EXTERNAL_STORAGE" />

<uses-feature android:name="[Link]" android:required="true" />

<uses-feature android:name="[Link]" android:required="false" />

Note: Camera, read and write permission need to take at runtime

Dependencies

Include the following dependency in your [Link] file:

// Default
implementation "[Link]:core-ktx:1.3.1"
implementation '[Link]:appcompat:1.2.0'
implementation '[Link]:constraintlayout:1.1.3'
implementation '[Link]:kotlin-stdlib:1.3.72'
implementation '[Link]:material:1.0.0'

// Mandatory
implementation("[Link].okhttp3:okhttp:4.5.0")
implementation '[Link]:exifinterface:1.2.0'
implementation '[Link]:localbroadcastmanager:1.0.0'
implementation '[Link].retrofit2:converter-gson:2.5.0'

// Required for AI camera

implementation "[Link]:camera-view:1.0.0-alpha15"
implementation "[Link]:camera-camera2:1.0.0-beta08"
implementation "[Link]:camera-lifecycle:1.0.0-beta08"
implementation '[Link]:preference:1.1.1'
implementation '[Link]:play-services-mlkit-face-detection:16.1.1'

Note: All version should be latest except camera APIs

In manifest add :

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

42
Possible error codes and reason:

Error Code
Reason

-1000 User Cancellation before KYC is complete.

1001 KYC successful completed

1002 KYC Failed

1004 Network Issues or if UIDAI’s webpage is down

1005 User exceeds OTP attempts on KYC page

1008 Required permission not provided

10012 User’s mobile number is not linked with Aadhaar

10015 Technical Exception from UIDAI

10016 UIDAI server error. Please try again in some time.

Sample code

// Declare list of task and id card

ArrayList<DigioTaskRequest> digioTaskList = new ArrayList<>();
ArrayList<DigioIDCardType> idCardList = new ArrayList<>();

/ Create ID card Analysis request /

DigioTaskRequest idCardRequest = new DigioTaskRequest();
[Link](true); // enable face match (Optional)
i [Link](false); // True for both side document photo
i [Link](60); // Optional, Face match default value is 60%
i [Link](false); // true validate from Government database
i [Link](DigioTaskType.ID_ANALYSIS) ;

[Link](DigioIDCardType.PAN) ; // optional (PAN, Voter ID, Passport, DL)

i [Link](idCardList); // assign IDcard type in object

/ Add analysis request in list /

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

43
d [Link](idCardRequest);
/************** **************** *************/

/ ** Create kyc request object **/ (If business wants multiple task at one time)
DigioTaskRequest kycRequest = new DigioTaskRequest();
[Link](DigioTaskType.OFFLINE_KYC); // For Aadhaar card
k [Link](false); // Optional, In case business required selfie and face match with
Aadhaar
k [Link](60); // Optional, Face match default value is 60%
k [Link](false); // Optional, Make it true to enable ML face detection
feature

/* Add KYC request in list */

d [Link](kycRequest);
/******* ******* *******/

/* Digio configuration */

igioKycConfig config = new DigioKycConfig();
D
[Link](DigioEnvironment.SANDBOX) ;
[Link](Color.parseColor("#17c39b"));
[Link](Color.parseColor("#B4E9D8"));

/ Digio session and pass request in sdk /

DigioStateLessSession digioStateLessSession = new DigioStateLessSession();

try {
// clientID and clientSecret key required
[Link](this,config,"clientID","clientSecret");
digioStateLessSession.startStateLessSession(digioTaskList, this);

//alternatively you can use below startSession method for billing reconciliation
/** d igioStateLessSession.startStateLessSession(digioTaskList,"referenceId",
"uniqueRequestId",this);
**/
} catch (Exception e) {
[Link]();
}

Sample Response

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

44
public void onDigioResponseSuccess(List<DigioTaskResponse> taskResponseList) {

for (DigioTaskResponse digiTaskResponse : taskResponseList) {

/ response param returns JSON object /

J SONObject mainResponse = digiTaskResponse.getResponse(); // offline_kyc or idCard analysis
response

/ task param will return the request against the task/

D igioTaskRequest digioTaskRequest = digiTaskResponse.getTask();

/** success param will give you the boolean value true/false **/
oolean value = digiTaskResponse.isSuccess();
b
}
}

Success Response
[
{
"task":{
"taskType":"OFFLINE_KYC",
"allowedSubTypes":[

],
"faceMatch":false,
"verify":false,
"isBothSide":false

},
"response":{
"personal_information":{
"date_of_birth":"21-08-1881",

"mobile_hash":"5eb9b114e9d8ee18e0df48724a6d6cbbf982aa822bd224924227aeef482014b0",

"email_hash":"5cc8265b2c2081761ad85e3d1c2632eb79ca6c1433a536be5052d42cd7277ccb",
"gender":"M",
"name":"John Sena"

},
"address_information":{
"country":"India",
"district":"bharatpur",
"house":"",
"location":"some colony",
"postal_code":"321203",
"post_office":"deeg",
"street":"",

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

45
"state":"rajasthan",
"sub_district":"deeg",
"virtual_town_centre":"city/town name",
"text":"some colony,deeg,deeg,deeg,bharatpur,rajasthan,India,321203"

},
"uidai_reference_id":"89462019060590990944446",

"photo":"\/9j\/4AAQSkZJRgABQABAAD\/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBw
gJC4nICIsIxwcKDcpLDNDL......",

"raw_encoded_xml":"PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvU9Im5vI
j8 + PE9mZmxpbmVQYXBllc3NLeWMgcmVmZXJlbmNlSWQ9IjI1MjkyMDIwMDYAyMjM1OTUxMy.....",

"encoded_zip":"UEsDBBQACQAIAP0SylAAAAAAAAAAAAAAAAAjluZWFhZGhhYXIyMDIwMDYxMDAyMjM1\nOTU
yNi54bWwsAaNDUaS2s.....",
"Share_code":"8679",
"selfie_uri": ""
},
"success":true

},
{
"task":{
"task_type":"ID_ANALYSIS",
"allowedSubTypes":[
"PAN"

],
"faceMatch":false,
"verify":false,
"isBothSide":false

},
"response":{
"analysis_response":{
"name":"John Sena",
"fathers_name":"John Sena",
"id_no":"CQQPGHGH6G",
"dob":"2/1/1994",
"id_type":"PAN",

"encoded_image":"iVBORw0KGgoAAAANSUhEUgAAACYAAAAsCAIAAACGxF2fAAAROklEQVR42mVXB1NbWZoVS
C8\/ PeX0lAUYsLFNE2XAIItgggSIIARIIIQAgRLJgJAIEiJncCCZYBvndrfb.........."

},
"selfie_uri": "",
"id_front_uri": "",
"id_back_uri": ""

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

46
},
"success":true

}
]

Failure Response

[{
"task":{
"taskType":"ID_ANALYSIS",
"allowedSubTypes":[
"PAN",
"VOTER_ID",
"PASSPORT"
],
"faceMatch":false,
"verify":false,
"isBothSide":false
},
"response":{
"responseCode":-1000,
"message":"User cancelled before completion."
},
"success":false
}
]

SDK Journey (Snapshots)

ID Card Analysis:

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

47
KYC Flow (Aadhaar offline XML):

Note: Digio reserves the right to modify this API document from time-to-time. If you are a business using this API, you will be notified well in advance, prior
to any change is made

Stateless API Digi
No ratings yet
Stateless API Digi
50 pages
Res
No ratings yet
Res
7 pages
PAN Card Application Details and Process
No ratings yet
PAN Card Application Details and Process
3 pages
PAN Card Application e-KYC Details
No ratings yet
PAN Card Application e-KYC Details
3 pages
N008465190 Signed
No ratings yet
N008465190 Signed
3 pages
Joint Declaration Application Request Letter
No ratings yet
Joint Declaration Application Request Letter
1 page
PAN Card Application eKYC Details
No ratings yet
PAN Card Application eKYC Details
3 pages
ID Card Printing Dashboard Overview
No ratings yet
ID Card Printing Dashboard Overview
3 pages
N005226629 Signed
No ratings yet
N005226629 Signed
3 pages
PAAM Register Report Summary 2022
No ratings yet
PAAM Register Report Summary 2022
12 pages
PAN Card eKYC Application Details
No ratings yet
PAN Card eKYC Application Details
3 pages
Overview of Aadhaar Card and Its Uses
No ratings yet
Overview of Aadhaar Card and Its Uses
12 pages
GDS ID
No ratings yet
GDS ID
2 pages
Aadhaar PVC Card Payment Receipt
No ratings yet
Aadhaar PVC Card Payment Receipt
1 page
Aadhaar Application and PAN Details
No ratings yet
Aadhaar Application and PAN Details
3 pages
R015649555
No ratings yet
R015649555
3 pages
PAN Application Details for Ansh Ashok
No ratings yet
PAN Application Details for Ansh Ashok
5 pages
PAN Card Application eKYC Details
No ratings yet
PAN Card Application eKYC Details
3 pages
PAN Application eKYC Details Form
No ratings yet
PAN Application eKYC Details Form
3 pages
Departmental Identity Card
No ratings yet
Departmental Identity Card
1 page
PAN Card Application Details
No ratings yet
PAN Card Application Details
2 pages
Divyangjan Card
No ratings yet
Divyangjan Card
1 page
N007437476 Signed
No ratings yet
N007437476 Signed
3 pages
PAN Application e-KYC Details
No ratings yet
PAN Application e-KYC Details
3 pages
PAAM Register Report Summary
No ratings yet
PAAM Register Report Summary
18 pages
Divyangjan Card
No ratings yet
Divyangjan Card
1 page
A 119026532
No ratings yet
A 119026532
2 pages
Pan Card PDF
No ratings yet
Pan Card PDF
3 pages
Aadhaar Card: Status and Uses Guide
No ratings yet
Aadhaar Card: Status and Uses Guide
8 pages
Creating Your ABC ID Card Guide
No ratings yet
Creating Your ABC ID Card Guide
6 pages
PAN Application Details for Gyas Naster
No ratings yet
PAN Application Details for Gyas Naster
5 pages
PAN Application Payment Details
No ratings yet
PAN Application Payment Details
5 pages
Bangladesh National ID Card Details
No ratings yet
Bangladesh National ID Card Details
10 pages
PAN Application Details and Guidelines
No ratings yet
PAN Application Details and Guidelines
2 pages
Advance FR Report #327750 11264387
No ratings yet
Advance FR Report #327750 11264387
5 pages
PAAM Register Report Summary 2022
No ratings yet
PAAM Register Report Summary 2022
18 pages
Aadhar Card Address Change Process
No ratings yet
Aadhar Card Address Change Process
2 pages
ID Card Application Form Template
No ratings yet
ID Card Application Form Template
1 page
A 118515086
No ratings yet
A 118515086
2 pages
PAN Application and Aadhaar Details Form
No ratings yet
PAN Application and Aadhaar Details Form
3 pages
PAN Application and Aadhaar Details Form
No ratings yet
PAN Application and Aadhaar Details Form
3 pages
Payment Reciept Aadhaar Card 2020-10-05 130759
No ratings yet
Payment Reciept Aadhaar Card 2020-10-05 130759
1 page
PAN Application e-KYC Details Form
No ratings yet
PAN Application e-KYC Details Form
3 pages
Aadhaar Identity Verification Guide
No ratings yet
Aadhaar Identity Verification Guide
3 pages
PAN Application Payment Details
No ratings yet
PAN Application Payment Details
5 pages
Application Number: Application Type : New Kyc Modification KYC
No ratings yet
Application Number: Application Type : New Kyc Modification KYC
40 pages
N007767815 Signed
No ratings yet
N007767815 Signed
3 pages
Documents
No ratings yet
Documents
5 pages
PAN Card Application Details
No ratings yet
PAN Card Application Details
2 pages
PAN Application e-KYC Details
No ratings yet
PAN Application e-KYC Details
3 pages
PAAM Register Report Summary
No ratings yet
PAAM Register Report Summary
12 pages
808411033-rrrrrrrrrrrrrrrrrrrrr-1 (2) (1) (3) (2) (2) (1) (1) (1) (2) (1) (1) (2) (5) (1) (3) (2) (1) (2) ... 1)
No ratings yet
808411033-rrrrrrrrrrrrrrrrrrrrr-1 (2) (1) (3) (2) (2) (1) (1) (1) (2) (1) (1) (2) (5) (1) (3) (2) (1) (2) ... 1)
1 page
PNB ATM/Debit Card Application Form
No ratings yet
PNB ATM/Debit Card Application Form
1 page
PNB ATM/Debit Card Application Form
71% (7)
PNB ATM/Debit Card Application Form
1 page
PAN Card Application Details Form
No ratings yet
PAN Card Application Details Form
2 pages
PAN Card Application Details Form
No ratings yet
PAN Card Application Details Form
2 pages
PAN Application Payment Details
No ratings yet
PAN Application Payment Details
2 pages
16 Point Compass Rose with Degrees
No ratings yet
16 Point Compass Rose with Degrees
4 pages
2nd Grade Math Problem Solving Template
No ratings yet
2nd Grade Math Problem Solving Template
16 pages
Introduction to ICT and Netiquette
No ratings yet
Introduction to ICT and Netiquette
12 pages
Graphics and Image Data Formats
No ratings yet
Graphics and Image Data Formats
37 pages
PJTSAU UG Admission Instructions 2023-24
No ratings yet
PJTSAU UG Admission Instructions 2023-24
3 pages
X-It - Part-B (Last Minute Revision)
No ratings yet
X-It - Part-B (Last Minute Revision)
100 pages
Creating An Account in Global Family Group Land Recording and Publishing System 73025
No ratings yet
Creating An Account in Global Family Group Land Recording and Publishing System 73025
60 pages
Professional All in One Online PDF Editor.
No ratings yet
Professional All in One Online PDF Editor.
8 pages
Understanding Still Images in Multimedia
100% (1)
Understanding Still Images in Multimedia
4 pages
Ethnopharmacology Submission Guidelines
100% (1)
Ethnopharmacology Submission Guidelines
9 pages
Image Classification for Bunkered Game
No ratings yet
Image Classification for Bunkered Game
44 pages
JRF Strategy. 1
No ratings yet
JRF Strategy. 1
45 pages
Amazon Seller Account Approval Guide
No ratings yet
Amazon Seller Account Approval Guide
4 pages
Oak Grabber V2 Download Log
No ratings yet
Oak Grabber V2 Download Log
29 pages
15 Essential Coding Tools for Developers
No ratings yet
15 Essential Coding Tools for Developers
64 pages
Disavowing Subdomains for SEO
No ratings yet
Disavowing Subdomains for SEO
22 pages
Logo Design Task for Academic Growth
No ratings yet
Logo Design Task for Academic Growth
3 pages
Assam Police Grade IV Staff Recruitment
No ratings yet
Assam Police Grade IV Staff Recruitment
8 pages
ACS MAPS Abstract Submission Guide
No ratings yet
ACS MAPS Abstract Submission Guide
21 pages
Online Tools for File Conversion
No ratings yet
Online Tools for File Conversion
2 pages
Oxford Big Read 2024 Competition Rules
No ratings yet
Oxford Big Read 2024 Competition Rules
10 pages
PowerPoint Normal View Components
No ratings yet
PowerPoint Normal View Components
35 pages
It 9626 Chapter 19 - Graphic Creation (Extended Summary)
No ratings yet
It 9626 Chapter 19 - Graphic Creation (Extended Summary)
4 pages
WyoLotto Brand Standards Guide
No ratings yet
WyoLotto Brand Standards Guide
18 pages
WideTEK® 12/25 Setup Guide
No ratings yet
WideTEK® 12/25 Setup Guide
44 pages
Bonafide Certificate for Computer Lab Work
No ratings yet
Bonafide Certificate for Computer Lab Work
39 pages
Understanding Multimedia and Graphics
No ratings yet
Understanding Multimedia and Graphics
26 pages
Spot Color Logo Printing Guide
No ratings yet
Spot Color Logo Printing Guide
42 pages
Environmental Challenges Author Guidelines
No ratings yet
Environmental Challenges Author Guidelines
31 pages
Huffman Coding for Text Compression in MATLAB
No ratings yet
Huffman Coding for Text Compression in MATLAB
47 pages

Digio API for ID Card Verification

Uploaded by

Digio API for ID Card Verification

Uploaded by

Getting started with Digio Stateless Cloud SaaS API

Getting started with Digio Stateless Cloud SaaS API 1

Digio Environments: Sandbox & Production 1

Indian Individuals (ID Cards | OCR and Verification) 2

Indian Individuals (ID Cards | Verification) 10

Aadhaar Masking API 14

Business Entity’s Verification 16

Face Match API 22

OCR API (Other than ID Cards) 23

UPI VPA Verification 24

Bank Account Verification (Penny Drop) 25

Aadhaar Offline XML KYC (Native app Android) 32

Android SDK with and without Machine Learning (Native app) 37

Digio Environments: Sandbox & Production

Environment BASE URL API Credentials

Sandbox [Link] Use Sandbox client id/client secret

Production [Link] Use Production client id/client secret

Below List of URLs and IP addresses need to be whitelisted, if required by

Copyright © 2019-20 | ​[Link]​ | For Limited Circulation

Indian Individuals (ID Cards | OCR and Verification)

Param Name Param Type Is Mandatory Description

front_part File Yes Front Part of ID Card

back_part File No Back Part of ID card

unique_request_id String No Unique request id for logging purpose

should_verify Boolean No Send true if analysed OCR output to be

Aaaaaa​​Denotes : Central Database Match Result

Copyright © 2019-20 | ​[Link]​ | For Limited Circulation

​"fathers_name"​: ​"Father’s Name as per PAN COPY"​,

​"encoded_signature"​: ​"base64 of cropped signature"​,

​"encoded_image"​: ​"base64 of photograph on PAN Card"​,

Success Response : Aadhaar

​"name"​: ​"​Amit Santhala​S"​,

​"id_no"​: ​"​xxxxxxxx4042​"​, ​[Complete Aadhaar no, please mask it before storing in

​"address"​: ​"\n\nWIO: Shiv Charan Gupta,\n6/MB/334, Indira Gandhi

Copyright © 2019-20 | ​[Link]​ | For Limited Circulation

​"encoded_image"​: ​"​base64 of photograph on Aadhaar Card​"​,

Success Response : Voter ID

​ ​"name"​: ​"Amit Sonthalia"​,

​"address"​: ​"Complete Address as per ID Card uploaded"​,

​"encoded_image"​: ​"base64 of photograph on VOTER ID"​,

​"address"​: ​Complete Address as per ID Card uploaded"​,

Copyright © 2019-20 | ​[Link]​ | For Limited Circulation

​"pc_name"​: ​"NORTH WEST DELHI "​,

​"last_update"​: ​"Tue Feb 11 20:36:31 IST 2020"​,

​"st_name"​: ​"NCT OF Delhi"​,

​"dist_name"​: ​"NORTH "​,

Copyright © 2019-20 | ​[Link]​ | For Limited Circulation

​"name"​: ​"ARSH DHRUV BAGHEL "​,

​"rln_name"​: ​"SATISH KUMAR "​,

​"part_name"​: ​"SECTOR-18 ROHINI"​,

​"id_no"​: ​"AFQ2053295 "

Success Response : Passport

Copyright © 2019-20 | ​[Link]​ | For Limited Circulation

​"encoded_image"​: ​"​base 64 of photograph on Passport​"​,

​"locality_or_post_office"​: ​"SAGAR NAGAR"​,

​"district_or_city"​: ​"VISAKHAPATNAM URBAN"​,

​"state"​: ​"ANDHRA PRADESH"​,

Success Response : Driving License

"name": ​": AKASH KUMAR"​,

"Date Of Issue": ​"20-Jun-2014"​,

"Old / New DL No.": ​"NA"​,

"Holder's Name": ​"AKASH KUMAR"​,

"Hazardous Valid Till": ​"NA"​,

"Non-Transport": ​"From: 20-Jun-2014"​,

"Transport": ​"From: NA"​,

Copyright © 2019-20 | ​[Link]​ | For Limited Circulation

"Last Transaction At": ​"DTO, BHOJPUR"

Success Response : Registration Certificate

​"engine_no"​: ​" U5S5FOEK079936"​,

​"chassis_no"​: ​" ME3U5S5FOEK079936"​,

​"Fuel Norms"​: ​"NOT AVAILABLE"​,

​"Maker / Model"​: ​"ROYAL-ENFIELD (UNIT OF EICHER LTD) / ENFIELD CLASSIC

​"Chassis No"​: ​"ME3U5S5F0EK0XXXXX"​,

​"Fitness Upto"​: ​"22-Dec-2029"​,

​"Owner Name"​: ​"ARVIND SENCHA"​,

​"Vehicle Class"​: ​"M-CYCLE/SCOOTER (2WN)"

Copyright © 2019-20 | [Link] | For Limited Circulation

AaaaaaDenotes : Central Database Match Result

Copyright © 2019-20 | [Link] | For Limited Circulation

"fathers_name": "Father’s Name as per PAN COPY",

"encoded_signature": "base64 of cropped signature",

"encoded_image": "base64 of photograph on PAN Card",

"name": "Amit SanthalaS",

"id_no": "xxxxxxxx4042", [Complete Aadhaar no, please mask it before storing in

"address": "\n\nWIO: Shiv Charan Gupta,\n6/MB/334, Indira Gandhi

Copyright © 2019-20 | [Link] | For Limited Circulation

"encoded_image": "base64 of photograph on Aadhaar Card",

"name": "Amit Sonthalia",

"address": "Complete Address as per ID Card uploaded",

"encoded_image": "base64 of photograph on VOTER ID",

"address": Complete Address as per ID Card uploaded",

Copyright © 2019-20 | [Link] | For Limited Circulation

"pc_name": "NORTH WEST DELHI ",

"last_update": "Tue Feb 11 20:36:31 IST 2020",

"st_name": "NCT OF Delhi",

"dist_name": "NORTH ",

Copyright © 2019-20 | [Link] | For Limited Circulation

"name": "ARSH DHRUV BAGHEL ",

"rln_name": "SATISH KUMAR ",

"part_name": "SECTOR-18 ROHINI",

"id_no": "AFQ2053295 "

Copyright © 2019-20 | [Link] | For Limited Circulation

"encoded_image": "base 64 of photograph on Passport",

"locality_or_post_office": "SAGAR NAGAR",

"district_or_city": "VISAKHAPATNAM URBAN",

"state": "ANDHRA PRADESH",

"name": ": AKASH KUMAR",

"Date Of Issue": "20-Jun-2014",

"Old / New DL No.": "NA",

"Holder's Name": "AKASH KUMAR",

"Hazardous Valid Till": "NA",

"Non-Transport": "From: 20-Jun-2014",

"Transport": "From: NA",

Copyright © 2019-20 | [Link] | For Limited Circulation

"Last Transaction At": "DTO, BHOJPUR"

"engine_no": " U5S5FOEK079936",

"chassis_no": " ME3U5S5FOEK079936",

"Fuel Norms": "NOT AVAILABLE",

"Maker / Model": "ROYAL-ENFIELD (UNIT OF EICHER LTD) / ENFIELD CLASSIC

"Chassis No": "ME3U5S5F0EK0XXXXX",

"Fitness Upto": "22-Dec-2029",

"Owner Name": "ARVIND SENCHA",

"Vehicle Class": "M-CYCLE/SCOOTER (2WN)"

Copyright © 2019-20 | [Link] | For Limited Circulation

Copyright © 2019-20 | [Link] | For Limited Circulation

Please pass id type from the list mentioned below in {id_card_type}

Response: Map of Id card properties to value from central database'

Copyright © 2019-20 | [Link] | For Limited Circulation

Copyright © 2019-20 | [Link] | For Limited Circulation

Copyright © 2019-20 | [Link] | For Limited Circulation

Copyright © 2019-20 | [Link] | For Limited Circulation

Copyright © 2019-20 | [Link] | For Limited Circulation

Copyright © 2019-20 | [Link] | For Limited Circulation

1. Success Response : FSSAI

Copyright © 2019-20 | [Link] | For Limited Circulation

2. Success Response : UAADHAR

Copyright © 2019-20 | [Link] | For Limited Circulation

3. Success Response : CIN

Copyright © 2019-20 | [Link] | For Limited Circulation

4. Success Response : DIN

5. Success Response : GST

Copyright © 2019-20 | [Link] | For Limited Circulation

Copyright © 2019-20 | [Link] | For Limited Circulation

Copyright © 2019-20 | [Link] | For Limited Circulation

Copyright © 2019-20 | [Link] | For Limited Circulation

Copyright © 2019-20 | [Link] | For Limited Circulation

Copyright © 2019-20 | [Link] | For Limited Circulation

Copyright © 2019-20 | [Link] | For Limited Circulation