post-request

Description: This API is used to send the OTP to the customer.
Base URL: https://apidev.iserveu.online/{EndPoint}
Endpoint: /common/dmt-lite/unified/otp/send

Headers

Content-Type: application/JSON
client_id: To be shared during integration
client_secret: To be shared during integration

 

Request Body Parameters

Parameters Description Data Type Example Mandatory/ Optional
customerMobileNumber Customer Mobile Number String 8144094480 Mandatory
externalRefNumber External Reference Number (Max. limit 6 to 22). (Mandatory for OTP type 2) String 1432452 Mandatory
requestedAmount Requested Amount(Mandatory for OTP type 2) String 1001 Optional
username Username String isutestapi1 Mandatory
otpType OTP Type would be 1 for Customer Registration and 2 for Transaction String 1 Mandatory
latLong Comma separated Latitude Longitude String 123.23,21.345 Optional
publicIP Public IP of Transaction device String 192.168.1.1 Optional
ovdType OVD Type String Aadhaar Card Mandatory
ovdData OVD Data (Optional for OTP type-2) String 765386439745 Mandatory
paramA To be used as per client requirement String to be used as per descretion Optional
paramB To be used as per client requirement String to be used as per descretion Optional
paramC To be used as per client requirement String to be used as per descretion Optional

Sample Request Body

NOTE -
  1. For “otpType”: “1” //External Reference no. not Required, OVD data is mandatory.
    1. Once a OTP API is called, then the next OTP can be called after an interval of 60s (with the same mobile number).
    2. An OTP can be generated for a maximum 3 times, if you want to regenerate need to wait for a time interval of 6 hours.
  2. For “otpType”: “2” //External Reference no. is Mandatory, OVD data is Optional..
    1. To regenerate the OTP, you have to change the client Reference ID.

Response Body Parameters

Parameters Description Data Type
status Transaction Enquiry Status Code. String
statusCode Code of the transaction status String
statusDesc Status Description String
paramA To be used as per client requirement String
paramB To be used as per client requirement String
paramC To be used as per client requirement String

Sample Response Body

Success:

{
  "status": "SUCCESS",
  "statusCode": "0",
  "statusDesc": "OTP Sent Successfully."
  "paramA": " ",
  "paramB": " ",
  "paramC": " "
}

Failed:

{
  "status": "FAILED",
  "statusCode": "1",
  "statusDesc": "Failed to send OTP"
  "paramA": "",
  "paramB": "",
  "paramC": ""
}

Response Codes

Status Code Response Type Description HTTP Status Code
0 SUCCESS OTP Sent Successfully 200
-1 FAILED Requested Amount Must Not be EMPTY Or Only Number Allowed 200