Request Method :: POST

Description: This API ensures secure authentication by validating One-Time Passwords (OTP) sent to user's mobile number.

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
mobilenumber	Contact number of the agent. E.g.- "8989897650"	10 digit number	String	Mandatory
otp	A temporary code used for authentication or verification. E.g.- "986754"	6 digit number	String	Mandatory
token	A temporary code used for authentication or verification. E.g.- "854162978825042025"	18 digit number	String	Mandatory

Sample Request Body

---

{ "bcagentid": "AOISU0003435", "mobilenumber": "8989897650", "otp": "986754", "token": "854162978825042025" }

Encrypted Sample Request Body

---

{ "RequestData": "qxKN/ MJlKeEsYj2NVJtbq9b583rWo10dex7lgV6mXlmGQepOio46m10T+tnxmwZKIrPb7Atxtnt0UwRQ3wSfDS 2ZXkOEJXrWUPxZ1j3wbzCtdozj7pBgx1mXQMIIOAKB" }

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:

{ "status": "SUCCESS", "statusCode": 0, "statusDesc": "User created successfully", "bcagentid": "AOISU0003435" }

 

FAILED:

The OTP has been already validated:

{ "status": "FAILED", "statusCode": 1, "statusDesc": "ERROTPV002:- OTP already validated!", "bcagentid": "AOISU0003435" }

Invalid BcagentId Provided:

{ "status": "FAILED", "statusCode": 1, "statusDesc": "ERRDUP01:- Please Enter Valid BcagentId", "bcagentid": "1234" }

Sample Response Body(Encrypted)

---

{ “ResponseData": "DC80H5pKsSSruYaXS4KH7o4VO8J9pRyF4QvO17hRXlo5VB40yU+TPsC1OedR3S00l2VvDFNUL6OvIX1 M4C3IsltoRQjsqBpE3DD5PQU2kH+/d8GTDIWoomSQUZeTzdwprhdXd0AqO4JluTCxxvdyvw==" }

Status Codes

Status	Status Code	Description
SUCCESS	0	User created successfully
FAILED	1	ERROTPV002:- OTP already validated! ERRDUP01:- Please Enter Valid BcagentId