post https://api.instantpay.in/identity/udyam
Instantpay's Udyam Verification API solution offers businesses a seamless solution to verify their clients' Udyam (MSME) registration details. By integrating this tool, businesses can streamline the due diligence process, ensuring accuracy in Udyam registration verification. Enhance the efficiency of customer onboarding and compliance with MSME regulations. Improve the reliability of your database and minimise the risk of errors by incorporating Instantpay's Udyam Verification API solution into your identity verification toolkit, creating a secure and compliant environment for your business.
Header Parameters
| Name | Type | Description | Mandatory (M) , Optional (O) | Provided by INSTANTPAY (Y/N) |
|---|---|---|---|---|
| X-Ipay-Auth-Code | String | Auth Code is "1" (Fixed) | M | Y |
| X-Ipay-Client-Id | String | Unique Client Id Provided by Instantpay | M | Y |
| X-Ipay-Client-Secret | String | Unique Client Secret Provided by Instantpay | M | Y |
| X-Ipay-Endpoint-Ip | String | End customer IP Address | M | Y |
Request Parameters
| Parameter Name | Type | Requirement | Description |
|---|---|---|---|
| udyamNumber | String | Mandatory | Udyam Number |
| 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/udyam' \
--header 'X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOQ8l80uxEOrgU6T3Oc4znVc=' \
--header 'X-Ipay-Client-Secret: 9e08574b440f1b4b13d19654cf31aa9b5d0b1effcc80785ded93ea87c5640fa7' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Endpoint-Ip: 49.249.72.66' \
--header 'Content-Type: application/json' \
--data '{
"udyamNumber" : "UDYAM-MH-19-XXXXX",
"externalRef" : "456566",
"latitude" : "27.999",
"longitude" : "24.898",
"consent" : "Y"
}'
POST /identity/udyam HTTP/1.1
Host: api.instantpay.in
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOQ8l80uxEOrgU6T3Oc4znVc=
X-Ipay-Client-Secret: 9e08574b440f1b4b13d19654cf31aa9b5d0b1effcc80785ded93ea87c5640fa7
X-Ipay-Auth-Code: 1
X-Ipay-Endpoint-Ip: 49.249.72.66
Content-Type: application/json
Content-Length: 159
{
"udyamNumber" : "UDYAM-MH-19-XXXXX",
"externalRef" : "456566",
"latitude" : "27.999",
"longitude" : "24.898",
"consent" : "Y"
}
Response Parameters
| Parameter Name | Type | Description |
|---|---|---|
| statuscode | String | Instantpay Status Code |
| actcode | String | Action Code |
| status | Array | Status message |
| data | String | Response Data(if Present) |
| timestamp | String | Response time (YYYY-MM-DD HH:II:SS) |
| ipay_uuid | String | Request reference number |
| orderid | String | Transaction Id(if transaction otherwise it is null) |
| environment | String | Live/Sandbox |
| internalCode | String | It will be null |
Sample Response
{
"statuscode": "TXN",
"actcode": null,
"status": "Transaction Successful",
"data": {
"udyamDetails": {
"udyamNumber": "UDYAM-DL-08-XXXXX",
"nameOfEnterprise": " Health and Fitness",
"typeOfEnterprise": "",
"majorActivity": "Services",
"organisationType": "Others",
"socialCategory": "General",
"dateOfIncorporation": "10/04/2019",
"dateOfCommencementOfProductionOrBusiness": "",
"unitDetails": [
{
"slNo": "1",
"unitName": "1",
"flat": "A 24/9 1ST FLOOR",
"building": "AWIFS",
"villageOrTown": "NEW DELHI",
"block": "A",
"road": "SARITA VIHAR",
"city": "DELHI",
"pincode": "110044",
"state": "DELHI",
"district": "SOUTH"
}
],
"officialAddress": {
"flatOrDoorOrBlockNo": "A 24/9 1ST FLOOR",
"NameOfPremisesOrBuilding": "",
"villageOrTown": "NEW DELHI",
"block": "A",
"roadOrStreetOrLane": "SARITA VIHAR",
"city": "DELHI",
"state": "DELHI",
"district": "SOUTH",
"pincode": "110044",
"mobile": "XXXXXXX934",
"email": "[email protected]"
},
"dic": "DELHI",
"msmeDi": "DELHI",
"dateOfUdyamRegistration": "28/01/2022"
},
"pool": {
"referenceId": "1230621093735GXQLH",
"openingBalance": "6.92",
"paymentAmount": "3.54",
"mode": "DR",
"closingBalance": "3.38"
}
},
"timestamp": "2023-06-21 09:37:35",
"ipay_uuid": "h0069975fda1-c5a7-408d-b5b0-c5a8fbac850b",
"orderid": "1230621093735GXQLH",
"environment": "LIVE",
"internalCode": null
}