=============== API DOCUMENTATION ==================

Token Generate

URL : https://easysmart.in/app/api/user/tokenGenerate

Method: POST
Data Type: JSON

========= Sample Request Data =======
{
 "apiKey": "sd021DFdxc1dSsdfs!fddf4755", /// Prodived by Us
 "userID": "ESAPI00001", /// Prodived by us
 "Pin": "111100000", /// Prodived by Us
 "password": "000111111" /// Prodived by Us
}

======= Sample Success Response =======
{
 "response_code": 1,
 "status": "Success",
 "message": "Login Successful",
 "login_access": true,
 "token": "QVBQQVBJVEtOMjAwMjE2ODc2OTU2NzQ2Mzcy"
}

======= Sample Failed Response =======
{
 "response_code": 101,
 "status": "False",
 "message": "API User Not Found."
}
{
 "response_code": 104,
 "status": "False",
 "message": "Api Pin Not Match."
}
{
 "response_code": 0,
 "status": "Failed",
 "message": "User ID or Password not Match"
}

Balance Check

URL : https://easysmart.in/app/api/user/balanceCheck

Method: POST
Data Type: JSON

========= Sample Request Data =======
{"token":"QVBQQVBJVEtOMjAwMjE2ODc2OTYzODc3NDMy"}

======= Sample Success Response =======
{
 "response_code": 1,
 "status": "Success",
 "message": "Wallet Balance Fetch Successful",
 "user_balance": "4368.00"
}

======= Sample Failed Response =======
{
 "response_code": 0,
 "status": "Failed",
 "message": "Token not found or Mis-Match"
}

NEW / CR (CSF) PAN CARD REQUEST

URL / END POINT : https://easysmart.in/app/api/nsdl/request

Method: POST
Data Type: JSON

========= Sample Request Data =======
{
 "api_key": "demo1545sdfsdf54dsf5sdfdfsd124545d",
 "env_mode":"UAT", // “UAT” FOR TEST | “LIVE” FOR PRODUCTION
 "app_type":"NEW", // “NEW” – NEW PAN | “CR” FOR CORRECTION PAN
 "app_mode":"K", // “K” – FOR E-KYC | “E” – FOR SCAN BASE APPLICATION
 "phyPanIsReq":"Y", // “Y” FOR Physical Pan Need | for e-Pan only “N”
 "redirect_url":"https://yourdamain/callback_url",
 "order_id":"DEMO0001213225555",
 "applicant_data": {
 "first_name":"JHONE",
 "middle_name":"",
 "last_name":"DEO",
 "gender":"M",
 "dob":"01/03/1993",
 "mobile_no":"9733665511",
 "email_id":"jhonedeo@gmail.com",
 "pan_no":""
 }
}

======= Sample Success Response =======
{
"status": "Success",
"response_code": 1,
"txnid": "DEMO0001213225555",
"message": "Data Return Success!",
"url": "https://preprod.assisted-service.egovnsdl.com/SpringBootFormHandling/newPanReq",
"enc_data": "{"reqEntityData":{"txnid":"DEMO0001213225555",
"reqTs":"2023-07-06T01: 48: 36: 000000",
"entityId":"FlowzyUAT",
"dscProvider":"Pantagon",
"dscSerialNumber":"7f7db07aa17f8d50",
"dscExpiryDate":"2025-06-10",
"returnUrl":"https://your_domain/callback",

"formData":"eyJhcHBsaWNhbnREdG8iOnsiYXBwbGlUeXBlIjoiQSIsImNhdGVnb3J5IjoiQSIsInRpdGx
lIjowLCJsYXN0TmFtZSI6IklTTEFNIiwiZmlyc3ROYW1lIjoiU0FGSUsiLCJtaWRkbGVOYW1lIjoiIiwiZG
9iIjoiMjkvMDMvMTk5OSIsImdlbmRlciI6Ik4iLCJjb25zZW50IjpmYWxzZSwibmFtZU9uUGFuQ2FyZCI6I
iIsImtub3duQnlPdGhlck5hbWUiOiIiLCJvdGhlclRpdGxlIjoiMCIsIm90aGVyTGFzdE5hbWUiOiIiLCJv
dGhlckZpcnN0TmFtZSI6IiIsIm90aGVyTWlkZGxlTmFtZSI6IiIsImFwcGxuTW9kZSI6IksiLCJuYW1lQXN
QZXJBYWRoYXIiOiIifSwicGFyZW50c0RldGFpbHMiOnsic2luZ2xlUGFyZW50IjoiIiwiZmF0aGVyTGFzdE
5hbWUiOiIiLCJmYXRoZXJGaXJzdE5hbWUiOiIiLCJmYXRoZXJNaWRkbGVOYW1lIjoiIiwibW90aGVyTGFzd
E5hbWUiOiIiLCJtb3RoZXJGaXJzdE5hbWUiOiIiLCJtb3RoZXJNaWRkbGVOYW1lIjoiIiwicGFyZW50TmFt
ZVByaW50IjoiIn0sIm90aGVyRGV0YWlscyI6eyJwaHlQYW5Jc1JlcSI6IiIsInNvdXJjZU9mSW5jb21lIjp
7InNhbGFyeSI6ZmFsc2UsIm90aGVyU291cmNlIjpmYWxzZSwiYnVzaW5lc3NQcm9mIjpmYWxzZSwiYnVzaW
5lc3NQcmZDb2RlIjoiMCIsIm5vSW5jb21lIjpmYWxzZSwiaG91c2VQcm8iOmZhbHNlLCJjYXBpdGFsR2Fpb
nMiOmZhbHNlfSwiYWRkckZvckNvbW11bmljYXRpb24iOiJub25lIiwib2ZmaWNlQWRkcmVzcyI6eyJmbGF0
Tm8iOiIiLCJuYW1lT2ZQcmVtaXNlcyI6IiIsInJvYWQiOiIiLCJhcmVhIjoiIiwidG93biI6IiIsImNvdW5
0cnlOYW1lIjoibm9uZSIsInN0YXRlIjoibm9uZSIsInBpbkNvZGUiOiIiLCJ6aXBDb2RlIjoiIiwib2ZmaW
NlTmFtZSI6IiJ9LCJpc2RDb2RlIjoiIiwic3RkQ29kZSI6IiIsInRlbE9yTW9iTm8iOiIiLCJlbWFpbElkI
joiIiwicGxhY2UiOiIiLCJkYXRlIjoiIiwicmVzaWRlbmNlQWRkcmVzcyI6eyJyZmxhdE5vIjoiIiwicm5h
bWVPZlByZW1pc2VzIjoiIiwicnJvYWQiOiIiLCJyYXJlYSI6IiIsInJ0b3duIjoiIiwicmNvdW50cnlOYW1
lIjoibm9uZSIsInJzdGF0ZSI6Im5vbmUiLCJycGluQ29kZSI6IiIsInJ6aXBDb2RlIjoiIn0sInJhVmFsdW
UiOiIiLCJyYVRpdGxlIjoiMCIsInJhTGFzdE5hbWUiOiIiLCJyYUZpcnN0TmFtZSI6IiIsInJhTWlkZGxlT
mFtZSI6IiIsInJhQWRkcmVzcyI6eyJyYUZsYXRObyI6IiIsInJhTmFtZU9mUHJlbWlzZXMiOiIiLCJyYVJv
YWQiOiIiLCJyYUFyZWEiOiIiLCJyYVRvd24iOiIiLCJyYUNvdW50cnlOYW1lIjoibm9uZSIsInJhU3RhdGU
iOiJub25lIiwicmFQaW5Db2RlIjoiIiwicmFaaXBDb2RlIjoiIn19LCJhb0NvZGUiOnsiYXJlYUNvZGUiOi
IiLCJhb1R5cGUiOiIiLCJyYW5nZUNvZGUiOiIiLCJhb05vIjoiIn19",
"authKey": "FlowzyUAT" },
"signature":
"hx8OVMy79N4rckGt0pPzml00JHyeeUYznin/+v0ZTFr6yQnhhkad4ETIXDe4kVT/DBOXRuVuPSunFMJ6TO
BIXLkAfOyp6+pG9cenf61np12Wx1w/SyhPTUQAatkdKgI+dPcJdnZW6GpBWVNYaj9LDpdw+H6/p6ESwrt63
o8edoB+k44WsKu67SdbNWlmoxneneDOzvNy7DmqzPSs947OCw0IzZ/QjUle/HvbFUd0InNQW8NrhGXai32/
jRneQW0UfxXdFGqPxGpgRJJuM+2eAZCK6ZsLkLdCnXagO5p8w6fZptr4ueFHof9TeYg2ectFokr7agzunwJ
TNrdayoTqPgu003du003d"
}"
}

======= Sample Failed Response =======
{
 "response_code": 0,
 "status": "Failed",
 "message": "User ID In-Active Please Contact to System Administrator"
}
{
 "response_code": 0,
 "status": "Failed",
 "message": "API User not Found or something went wrong
"
}

. NSDL Callback for Return Response (Callback Request)

URL : Provied by API Partner End

Method: GET
Data Type: Query Param

========= Sample Callback Query Param Data =======
Param :
1. order_id = Order id what pass from your end.
2. ack = PAN Akcknolegement No
3. status = 1 for Sucees and 0 for Failed
4. encData = Encryption data of base64encrypting
https://your_domain /nsdl/callback?order_id=265D77FLZ1688568111&status=1&status=1&encData=dsf4dfsd5f4sd6f4sd6f4sd65f4sd65f

NSDL – PAN Transaction Status Check

URL / END POINT : https://easysmart.in/app/api/nsdl/transactionStatus

Method: POST
Data Type: JSON

========= Sample Request Data =======
{
 "api_key": "demo1545sdfsdf54dsf5sdfdfsd124545d",
 "order_id":"DEMO0001213225555", What pass on PAN Request
 "txn_id":"UNIQTXN0000122", Unique New Txn id
}

======= Sample Success Response =======
{
 "response_code": 1,
 "status": "Success",
 "order_id":"DEMO0001213225555",
 "ack": "920215565664554555", // Ack NO provide by NSDL / Protean
 "message": "Transaction Status check Success"
}

======= Sample Failed Response =======
{
 "response_code": 0,
 "status": "Failed",
 "message": "User ID In-Active Please Contact to System Administrator"
}
{
 "response_code": 0,
 "status": "Failed",
 "message": "API User not Found or something went wrong"
}

NSDL – PAN Ack Status Check

URL / END POINT : https://easysmart.in/app/api/nsdl/panAckStatus

Method: POST
Data Type: JSON

========= Sample Request Data =======
{
 "api_key": "demo1545sdfsdf54dsf5sdfdfsd124545d",
 "ack":"920215565664554555", What you received from NSDL / Protean.
 "txn_id":"UNIQTXN0000122", Unique New Txn id
}

======= Sample Success Response =======
{
 "response_code": 1,
 "status": "Success",
 "order_id":"DEMO0001213225555",
 "ack": "920215565664554555", // Ack NO provide by NSDL / Protean
 "message": "PAN Card under process in Income Tax depertment."
}

======= Sample Failed Response =======
{
 "response_code": 0,
 "status": "Failed",
 "message": "User ID In-Active Please Contact to System Administrator."
}
{
 "response_code": 0,
 "status": "Failed",
 "message": "API User not Found or something went wrong."
}

NSDL pan card api docs