Verification Suite API

This a collection of API used for Verification Suite.

Verification Suite

POST https://dashboard.finzen.money/api/v1/public/verification/

Headers

Name	Type	Description
x-merchant-email*	String	Registered merchant email
x-api-key*	String	API Key, Can be generated from dashboard
x-api-secret*	String	API Secret, Can be generated from dashboard

Request Body

Name	Type	Description
debit_from*	String (20, 20)	Request to pass the VAN account number you want to debit from
verification_type*	String	Verify with the below verification type BANK, PAN, DRIVING_LICENSE, VOTER_ID, PASSPORT, CIN, GSTIN, AADHAAR, IFSC
Verification Object	String	Below are all of the verification objects

Sample Request for PAN

{
    "debit_from": "00016459898989871",
    "verification_type": "PAN",
    "pan": {
        "pan_number": "ABCDE1000D"
    },

200 Details verified successfully

{
    "success": true,
    "http_code": 200,
    "message": "Details verified successfully",
    "data": {
        "verification_id": "26392884512043830097",
        "source_type": "PAN",
        "doc_number": "ABCDE1000D",
        "commission": 5,
        "tax": 0.9,
        "verification_status": "Success",
        "verify_response": {
            "pan": "ABCDE1000D",
            "type": "Individual",
            "reference_id": 82540000,
            "name_provided": "",
            "registered_name": "ABC XYZ",
            "father_name": "",
            "valid": true,
            "message": "PAN verified successfully"
        }
    }
}

401 Unauthorized

{
    "success": false,
    "http_code": 401,
    "message": "API Credentials is not valid"
}

Verification Object

Verification Object	Type
"pan": { "pan_number": "ABCDE0000F" }	PAN
"bank" :{ "account_no": "995001512345", "ifsc_code": "ICIC0000000" }	BANK
"dl": { "dl_number": "AP0420120022200", "dob": "1992-08-31" }	DRIVING_LICENSE
"voter_id": { "voter_id_number": "ABC1419000" }	VOTER_ID
"passport": { "file_number": "AB1234167897000", "dob": "1990-07-28" }	PASSPORT
"cin": { "cin_number": "U12345AP2021PTC148181" }	CIN
"gstin": { "gstin_number": "24ABCDE4866F1XX" }	GSTIN
"aadhaar": { "aadhaar_number": "123456789123", "otp": "", "ref_id": "" }	AADHAAR
"ifsc": { "ifsc_code": "ICICXXX65XX" }	IFSC

Get Verification Details

Use this API to get details of the verification request. You need to pass only the verification ID

GET https://dashboard.finzen.money/api/v1/public/verification/263926392884512043830097

Headers

Name	Type	Description
x-merchant-email*	String	Registered merchant email
x-api-key*	String	API Key, Can be generated from dashboard
x-api-secret*	String	API Secret, Can be generated from dashboard

Path

Name	Type	Description
verification_id*	String	This is the unique identifier returned in response to the verification request.

200 Details verified successfully

{
    "success": true,
    "http_code": 200,
    "message": "Verification details retrieved successfully",
    "data": {
        "verification_id": "26392884512043830097",
        "source_type": "PAN",
        "doc_number": "ABCDE1000D",
        "commission": 5,
        "tax": 0.9,
        "verification_status": "Success",
        "verify_response": {
            "pan": "ABCDE1000D",
            "type": "Individual",
            "reference_id": 82540000,
            "name_provided": "",
            "registered_name": "ABC XYZ",
            "father_name": "",
            "valid": true,
            "message": "PAN verified successfully"
        }
    }
}

401 Unauthorized

{
    "success": false,
    "http_code": 401,
    "message": "API Credentials is not valid"
}