Merchant Inquiry
Authentication
Authentication Process
Documentations
Documentations for API
End Points
http://10.0.0.13:8080/zconnect/api/v1/QR/MerchantInq
Http Method
POST
Header
| Name | Type | Values | Description |
|---|---|---|---|
| clientSecret | TEXT | Access-Token | Auth2.0 verification |
| Accept | JSON | application/json | application/json |
| Content-Type | JSON | application/json | application/json |
| clientId | TEXT | ************* | ************* |
| organizationId | TEXT | 223 | Authenticate organization |
Request Parameters
| Name | Description | Required | Parameter Type | Length | Sample Value |
|---|
Sample Request
{
"MerchantInqReq": {
"LoginToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
"Os": "Android",
"Segment": "CMPAK",
"DueDate": "",
"DuePyblAmt": "",
"IBAN": "PK51JSBL9999903040200070",
"Mobile": "03040200070",
"Theme": 0,
"UUID": "81fe896ff91c542f"
}
}
Response Parameters
| Name | Description | Parameter Type | Length | Sample Value |
|---|
Response Sample
{
"MerchantInqRes": {
"ResponseCode": "03",
"ResponseDescription": "Your documents have been submitted and are under review. In case of any discrepancies, you will be informed of the same. In the mean time, you may use your Merchant account.",
"BusinessName": "Zong Testing",
"Till": "946150236",
"QRText": "",
"Title": "",
"Description": "",
"Share": true,
"Download": true,
"IBAN": "PK51JSBL9999903040200070",
"MerchantUpdateStatus": {
"BusinessNameTrueFalse": null,
"BusinessName": "",
"BusinessAddressTrueFalse": null,
"BusinessAddress": "",
"CNICFrontTrueFalse": null,
"CNICFront": "",
"CNICBackTrueFalse": null,
"CNICBack": "",
"SelfieTrueFalse": null,
"Selfie": "",
"ProofOfBusinessTrueFalse": true,
"ProofOfBusiness": ""
},
"MerchantTandC": {
"ID": 10,
"Title": "",
"Limit": "Rs. 500,000",
"LimitIndex": 1002,
"TandC": "",
"Button": "Let's Get Started",
"Image": "",
"MerchantTandCItems": [
{
"ID": 1000,
"Description": "Signup as a Zindigi merchant if you are running your own business",
"Icon": "https:\/\/zindigi-qa.appinsnap.com\/android\/Content\/QR\/Merchant\/Dark\/arrow.png"
},
{
"ID": 1001,
"Description": "Start receiving QR payments from your customers instantly",
"Icon": "https:\/\/zindigi-qa.appinsnap.com\/android\/Content\/QR\/Merchant\/Dark\/arrow.png"
},
{
"ID": 1002,
"Description": "monthly receiving & sending limits",
"Icon": "https:\/\/zindigi-qa.appinsnap.com\/android\/Content\/QR\/Merchant\/Dark\/arrow.png"
}
],
"MerchantBusinessTypes": [
{
"ID": 10,
"Title": "Service & Fuel Station",
"MCC": "5541"
},
{
"ID": 11,
"Title": "Fast Food Restaurants",
"MCC": "5814"
},
{
"ID": 12,
"Title": "Grocery Stores & Supermarkets",
"MCC": "5411"
},
{
"ID": 13,
"Title": "Department Stores",
"MCC": "5311"
},
{
"ID": 14,
"Title": "Restaurants & Eating Places",
"MCC": "5812"
},
{
"ID": 15,
"Title": "Digital Goods",
"MCC": "5818"
},
{
"ID": 16,
"Title": "Clothing Stores",
"MCC": "5651"
},
{
"ID": 17,
"Title": "Pharmacies & Medical Stores",
"MCC": "5912"
},
{
"ID": 18,
"Title": "Advertising Services",
"MCC": "7311"
},
{
"ID": 19,
"Title": "Bakeries & Sweets",
"MCC": "5462"
},
{
"ID": 20,
"Title": "Cable, TV and Radio Services",
"MCC": "4899"
},
{
"ID": 21,
"Title": "Petroleum Products",
"MCC": "5172"
},
{
"ID": 22,
"Title": "Miscellaneous Business Services",
"MCC": "7399"
},
{
"ID": 23,
"Title": "Shoe Stores",
"MCC": "5661"
},
{
"ID": 24,
"Title": "Miscellaneous Food Stores",
"MCC": "5499"
},
{
"ID": 25,
"Title": "Variety Stores",
"MCC": "5331"
},
{
"ID": 26,
"Title": "Freelance Services (Development, Data, Design)",
"MCC": "7372"
},
{
"ID": 27,
"Title": "Computer Software Stores",
"MCC": "5734"
},
{
"ID": 28,
"Title": "Fuel Dealers",
"MCC": "5983"
},
{
"ID": 29,
"Title": "Book Stores",
"MCC": "5942"
},
{
"ID": 30,
"Title": "Hospitals & Clinics",
"MCC": "8062"
},
{
"ID": 31,
"Title": "Taxi, Cabs, Transportation",
"MCC": "4121"
},
{
"ID": 32,
"Title": "Government Services",
"MCC": "9399"
},
{
"ID": 34,
"Title": "Mobile Shops",
"MCC": "5271"
}
],
"MerchantCities": [
{
"ID": 100,
"Name": "Abbottabad",
"Province": "Kpk"
},
{
"ID": 101,
"Name": "Agrow Chishtian",
"Province": "Punjab"
},
{
"ID": 102,
"Name": "Arifwala",
"Province": "Punjab"
},
{
"ID": 103,
"Name": "Attock",
"Province": "Punjab"
},
{
"ID": 104,
"Name": "Badin",
"Province": "Sindh"
}
],
"MerchantMonthlyExpectedSales": [
{
"ID": 10,
"Range": "1 - 50,000"
},
{
"ID": 11,
"Range": "50,001 - 100,000"
},
{
"ID": 12,
"Range": "100,001 - 300,000"
},
{
"ID": 13,
"Range": "300,001 - 500,000"
},
{
"ID": 14,
"Range": "Above 500,000"
}
]
},
"QRSecurityQuestionAnswers": {
"ID": 2,
"Question": "What is your place of birth?",
"QRSecurtiyAnswers": [
{
"ID": 1,
"Answer": "abbotabad"
},
{
"ID": 1,
"Answer": "faisalabad"
},
{
"ID": 1,
"Answer": "hyderabad"
},
{
"ID": 1,
"Answer": "sahiwal"
}
]
}
}
}
Response Code Details
{
"MerchantInqRes": {
"ResponseCode": "03",
"ResponseDescription": "Your documents have been submitted and are under review. In case of any discrepancies, you will be informed of the same. In the mean time, you may use your Merchant account.",
"BusinessName": "Zong Testing",
"Till": "946150236",
"QRText": "",
"Title": "",
"Description": "",
"Share": true,
"Download": true,
"IBAN": "PK51JSBL9999903040200070",
"MerchantUpdateStatus": {
"BusinessNameTrueFalse": null,
"BusinessName": "",
"BusinessAddressTrueFalse": null,
"BusinessAddress": "",
"CNICFrontTrueFalse": null,
"CNICFront": "",
"CNICBackTrueFalse": null,
"CNICBack": "",
"SelfieTrueFalse": null,
"Selfie": "",
"ProofOfBusinessTrueFalse": true,
"ProofOfBusiness": ""
},
"MerchantTandC": {
"ID": 10,
"Title": "",
"Limit": "Rs. 500,000",
"LimitIndex": 1002,
"TandC": "",
"Button": "Let's Get Started",
"Image": "",
"MerchantTandCItems": [
{
"ID": 1000,
"Description": "Signup as a Zindigi merchant if you are running your own business",
"Icon": "https:\/\/zindigi-qa.appinsnap.com\/android\/Content\/QR\/Merchant\/Dark\/arrow.png"
},
{
"ID": 1001,
"Description": "Start receiving QR payments from your customers instantly",
"Icon": "https:\/\/zindigi-qa.appinsnap.com\/android\/Content\/QR\/Merchant\/Dark\/arrow.png"
},
{
"ID": 1002,
"Description": "monthly receiving & sending limits",
"Icon": "https:\/\/zindigi-qa.appinsnap.com\/android\/Content\/QR\/Merchant\/Dark\/arrow.png"
}
],
"MerchantBusinessTypes": [
{
"ID": 10,
"Title": "Service & Fuel Station",
"MCC": "5541"
},
{
"ID": 11,
"Title": "Fast Food Restaurants",
"MCC": "5814"
},
{
"ID": 12,
"Title": "Grocery Stores & Supermarkets",
"MCC": "5411"
},
{
"ID": 13,
"Title": "Department Stores",
"MCC": "5311"
},
{
"ID": 14,
"Title": "Restaurants & Eating Places",
"MCC": "5812"
},
{
"ID": 15,
"Title": "Digital Goods",
"MCC": "5818"
},
{
"ID": 16,
"Title": "Clothing Stores",
"MCC": "5651"
},
{
"ID": 17,
"Title": "Pharmacies & Medical Stores",
"MCC": "5912"
},
{
"ID": 18,
"Title": "Advertising Services",
"MCC": "7311"
},
{
"ID": 19,
"Title": "Bakeries & Sweets",
"MCC": "5462"
},
{
"ID": 20,
"Title": "Cable, TV and Radio Services",
"MCC": "4899"
},
{
"ID": 21,
"Title": "Petroleum Products",
"MCC": "5172"
},
{
"ID": 22,
"Title": "Miscellaneous Business Services",
"MCC": "7399"
},
{
"ID": 23,
"Title": "Shoe Stores",
"MCC": "5661"
},
{
"ID": 24,
"Title": "Miscellaneous Food Stores",
"MCC": "5499"
},
{
"ID": 25,
"Title": "Variety Stores",
"MCC": "5331"
},
{
"ID": 26,
"Title": "Freelance Services (Development, Data, Design)",
"MCC": "7372"
},
{
"ID": 27,
"Title": "Computer Software Stores",
"MCC": "5734"
},
{
"ID": 28,
"Title": "Fuel Dealers",
"MCC": "5983"
},
{
"ID": 29,
"Title": "Book Stores",
"MCC": "5942"
},
{
"ID": 30,
"Title": "Hospitals & Clinics",
"MCC": "8062"
},
{
"ID": 31,
"Title": "Taxi, Cabs, Transportation",
"MCC": "4121"
},
{
"ID": 32,
"Title": "Government Services",
"MCC": "9399"
},
{
"ID": 34,
"Title": "Mobile Shops",
"MCC": "5271"
}
],
"MerchantCities": [
{
"ID": 100,
"Name": "Abbottabad",
"Province": "Kpk"
},
{
"ID": 101,
"Name": "Agrow Chishtian",
"Province": "Punjab"
},
{
"ID": 102,
"Name": "Arifwala",
"Province": "Punjab"
},
{
"ID": 103,
"Name": "Attock",
"Province": "Punjab"
},
{
"ID": 104,
"Name": "Badin",
"Province": "Sindh"
}
],
"MerchantMonthlyExpectedSales": [
{
"ID": 10,
"Range": "1 - 50,000"
},
{
"ID": 11,
"Range": "50,001 - 100,000"
},
{
"ID": 12,
"Range": "100,001 - 300,000"
},
{
"ID": 13,
"Range": "300,001 - 500,000"
},
{
"ID": 14,
"Range": "Above 500,000"
}
]
},
"QRSecurityQuestionAnswers": {
"ID": 2,
"Question": "What is your place of birth?",
"QRSecurtiyAnswers": [
{
"ID": 1,
"Answer": "abbotabad"
},
{
"ID": 1,
"Answer": "faisalabad"
},
{
"ID": 1,
"Answer": "hyderabad"
},
{
"ID": 1,
"Answer": "sahiwal"
}
]
}
}
}
{
"messages": "Bad Request - Invalid Access Token",
"errorcode": "4001"
}
{
"messages": "Bad Request - Invalid Request Payload",
"errorcode": "4002"
}
{
"messages": "Bad Request - Invalid Authorization Header",
"errorcode": "4003"
}
{
"messages": "Something Went Wrong",
"errorcode": "4004"
}
{
"messages": "Record Not Found",
"errorcode": "4005"
}
{
"messages": "Invalid Client Id\/Secret",
"errorcode": "4006"
}
{
"messages": "Bad Request - Invalid Access Token",
"errorcode": "4007"
}
Try out yourself
Security
X-IBM-Client-Id(apiKey located in header)
X-IBM-Client-Secret(apiKey located in header)
1c48aa28-2614-486f-aa2c-cbc86cc7ab51
1c48aa28-2614-486f-aa2c-cbc86cc7ab51
Header Parameter
| Name | Values | Description |
|---|---|---|
| Content-Type | application/json | Content Type application/json is supported |
| Accept | application/json | Content Type application/json is supported |
| organizationId | xyz | You will make a call to the auth-blb api and give it your client ID. You should add the client secret and organization ID it returns here. |
| clientId | Enter your verified Client Id | |
| clientSecret | Enter Your Verified Client Secret |
Request Body
Copy
Response Body
Copy