Request Method :: POST
Description: The Bio-Auth Based Onboarding API ensures a secure and seamless registration process for merchants by verifying their mobile numbers and agent PID data.

Headers

Content-Type: application/JSON
header_secrets:  To be shared during integration by ISU Team
pass_key:  To be shared during integration by ISU Team

Request Body Parameters

Parameters Parameter description with examples Validation Data type Mandatory/Optional
bcagentid Unique ID assigned to the business correspondent (BC) agent.
E.g.- "AOISU0003435"		 Alphanumeric Min 5, Max 15 String Mandatory
bcagentname Name of the BC agent.
E.g.- "Rahul"		 Alphanumeric Min 5, Max 15 String Mandatory
lastname Last name of the agent.
E.g.- "dash"		 Alphanumeric Min 5, Max 15 String Mandatory
mobilenumber Contact number of the agent.
E.g.- "8989897650"		 10 digit number String Mandatory
email Contact email of the agent.
E.g.- "[email protected]"		 Proper email format as example String Mandatory
pancard PAN card number of the agent.
E.g.- "ERFPP0988S"		 Alphanumeric and all in caps String Mandatory
aadhar_no Aadhar number of the agent.
E.g. -"345098761234"		 12 digit number String Mandatory
companyname Name of the company providing the service.
E.g.- "Iserveu"		 Alphanumeric Min 5, Max 15 String Mandatory
address Registered address of the agent.
E.g.- "KIRTI NAGAR DELHI"		 Alphanumeric Min 3, Max 100 String Mandatory
area Agent’s area of location.
E.g.- "KIRTI NAGAR DELHI"		 Alphanumeric Min 5, Max 50 String Mandatory
pincode Postal code of the agent's address.
E.g. – 759012		 6 digit number Integer Mandatory
shopaddress Address of the agent’s shop.
E.g.- "KIRTINAGARDELHI"		 Alphanumeric Min 5, Max 100 String Mandatory
shoparea Area where the shop is located.
E.g.- "KIRTI NAGAR DELHI"		 Alphanumeric Min 5, Max 50 String Mandatory
shopcity City where the shop is located.
E.g.- "Delhi"		 Alphanumeric Min 1, Max 15 String Mandatory
shopdistrict District where the shop is located.
E.g.- "Delhi"		 Alphanumeric Min 1, Max 20 String Mandatory
shopname Name of the shop.
E.g.- "Rj Shop"		 Alphanumeric Min 5, Max 100 String Mandatory
shoppincode Postal code of the shop’s location.
E.g.- "758093"		 6 digit number Integer Mandatory
shopstate State where the shop is located.
E.g.- "Delhi"		 Alphanumeric Min 5, Max 15 String Mandatory
lat Latitude coordinate of the shop location.
E.g. - "22.34"		 Accepts Decimal number String Mandatory
long Longitude coordinate of the shop location.
E.g. - "23.4509"		 Accepts Decimal number String Mandatory
customerreferenceno Customer reference number.
E.g. - "342543664657"		 Alphanumeric Min 5, Max 20 String Mandatory
piddata Encrypted PID data.
E.g. - "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz…"		 Encrypted data String Mandatory

Sample Request Body

Encrypted Sample Request Body

Response Body Parameters

Parameters Parameter description with examples Data type
status Status of the operation (SUCCESS/FAILED) String
statusCode Status Code String
statusDesc Status Description. string
bcagentid Unique ID assigned to the BC agent. String

Sample Response Body

SUCCESS:

 

FAILED:

Sample Response Body(Encrypted)

Status Codes

Status Status Code Description
SUCCESS 0 OTP sent successfully.
FAILED 1 ERROTP001:- Mobile number already registered