Driving License Verification

The Driving License Verification API solution by Instantpay allows businesses to authenticate the validity of a driver's licence swiftly and accurately.

Employ this feature to enhance security measures, confirming the authenticity of driving licences during various transactions and interactions, contributing to a safer and more reliable operational environment.

Additionally, the API facilitates the extraction of personal information, including permissible types of vehicles, along with the provision of RTO-registered user photos, further enhancing the comprehensive verification process.

Header Parameters

NameTypeDescriptionMandatory (M) , Optional (O)Provided by INSTANTPAY (Y/N)
X-Ipay-Auth-CodeStringAuth Code is "1" (Fixed)MY
X-Ipay-Client-IdStringUnique Client Id Provided by InstantpayMY
X-Ipay-Client-SecretStringUnique Client Secret Provided by InstantpayMY
X-Ipay-Endpoint-IpStringEnd customer IP AddressMY

Request Parameters

Parameter Name

Type

Requirement

Description

drivingLicenseNumber

String

Mandatory

Driving License Number

dob

String

MAndatory

Date of birth linked with Driving License (format YYYY-MM-DD)

latitude

String

Mandatory

End Customer Latitude.

longitude

String

Mandatory

End Customer Longitude

externalRef

String

Mandatory

Your Unique Transaction id

consent

String

Mandatory

Consent should be
accepted by
customer

Sample Request

curl --location 'https://api.instantpay.in/identity/verifyDrivingLicense' \
--header 'X-Ipay-Auth-Code: {{authCode}}' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{clientSecret}}' \
--header 'X-Ipay-Endpoint-Ip: {{endPointIP}}' \
--header 'Content-Type: application/json' \
--data '{
    "drivingLicenseNumber":"MH09 123456789",
    "dob" : "2000-12-01",
    "consent":"Y",
    "latitude":0.99,
    "longitude":38,
    "externalRef":"jdnjdi89"
}'
POST /identity/verifyDrivingLicense HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=
X-Ipay-Client-Secret: 679db35f926b8d0240a8c0d28729528ee8e6d5effa5fa0b20c04454004d2d825
X-Ipay-Endpoint-Ip: 14.142.186.142
Content-Type: application/json
Content-Length: 139

{
    "drivingLicenseNumber":"MH09 123456789",
    "dob" : "2000-12-01",
    "consent":"Y",
    "latitude":0.99,
    "longitude":38,
    "externalRef":"jdnjdi89"
}

Response Parameters

Parameter NameTypeDescription
statuscodeStringInstantpay Status Code
actcodeStringAction Code
statusArrayStatus message
dataStringResponse Data(if Present)
timestampStringResponse time (YYYY-MM-DD HH:II:SS)
ipay_uuidStringRequest reference number
orderidStringTransaction Id(if transaction otherwise it is null)
environmentStringLive/Sandbox
internalCodeStringIt will be null

Sample Response

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Transaction Successful",
    "data": {
        "drivingLicenseDetail": {
            "userAddress": [
                {
                    "addressLine1": "Sample Address",
                    "completeAddress": "Full Address",
                    "country": "INDIA",
                    "district": "TAL-PANHALA,",
                    "pin": "",
                    "state": "Maharashtra",
                    "type": "Permanent"
                },
                {
                    "addressLine1": "Sample Address,",
                    "completeAddress": "Full Address",
                    "country": "INDIA",
                    "district": "TAL-PANHALA,",
                    "pin": "",
                    "state": "Maharashtra",
                    "type": "Present"
                }
            ],
            "userBloodGroup": "U",
            "dlNumber": "MH09 123456789",
            "userDob": "07/05/2000",
            "endorseDate": "",
            "endorseNumber": "",
            "expiryDate": "28/02/2020",
            "fatherOrHusband": "Sample Name",
            "issuedDate": "29/02/2000",
            "nonTransportValidity": {
                "from": "29/02/2000",
                "to": "28/02/2020"
            },
            "state": "Maharashtra",
            "status": "Active",
            "statusDetails": {
                "from": "",
                "remarks": "",
                "to": ""
            },
            "transportValidity": {
                "from": "",
                "to": ""
            },
            "userFullName": "Sample Name",
            "userImage": "/9j/4AAQhAMVm9O1yXvI4ZgJVLbDIDyD/MVoweDyD2Q==",
            "vehicleCategoryDetails": [
                {
                    "cov": "MCWG",
                    "expiryDate": "",
                    "issueDate": ""
                },
                {
                    "cov": "LMV",
                    "expiryDate": "",
                    "issueDate": ""
                }
            ]
        },
        "pool": {
            "referenceId": "1231005102115NHXPE",
            "openingBalance": "47.77",
            "paymentAmount": "0.00",
            "mode": "DR",
            "closingBalance": "47.77"
        }
    },
    "timestamp": "2023-10-05 10:21:15",
    "ipay_uuid": "h0059a4b4991-b430-4411-80fe-f5c24af38c84-jPAvyqyJmw4H",
    "orderid": "1231005102115NHXPE",
    "environment": "LIVE",
    "internalCode": null
}
Language
Click Try It! to start a request and see the response here!