Skip to main content

Validate OTP

Validate OTP

Postman Collection

URL

POST : /v1/service/aeps/validateOTP

Headers

Content-Type  (String)   required
application/json
Authorization  (String)   required
Basic Auth
Accept  (String)   required
application/json

Body Params

merchantCode  (String)   Required
Merchant unique Code (You will get merchantCode from Merchant Onboarding API) (Max Length: 50)
mobile  (String)   Required
Merchant mobile Number (Max Length: 10)
otp  (String)   Required
Received on Merchant Mobile Number (Max Length: 10)
routeType  (String)   Required
Api Service Type (Like icici) (Max Length: Fixed)
requestId  (String)   Required
You will get a requestId from send OTP Api Response (Max Length: 150)
token  (String)   Required
You will get a token from send OTP Api Response (Max Length: 100)
primaryId  (String)   Required ( In case of ICICI )
You will get a primaryId from send OTP Api Response (Max Length: 50)

Request

Example Request
curl --location --request POST '/v1/service/aeps/validateOTP' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic e3tsb2NfdXNlcn19Ont7bG9jX3Bhc3N9fQ==' \
--data-raw '{
"merchantCode": "MC000123123",
"mobile": "9999999999",
"otp": "6390089",
"primaryId": "805754",
"requestId": "e098fdb6-f2cd-4c5d-9e98-0f41fdc9ab9d",
"token":"9ec3f2c4-68b9-4442-91be-e3fc61aca7be",
"routeType":"icici"
}'

Response Samples

{
"code": "0x0200",
"message": "000: Validate OTP successfully.",
"status": "SUCCESS",
"data": {
"token": "794d213a-3187-4a66-9ad6-b151451d314c",
"requestId": "e31abb0c-7066-40d9-9350-881b25b398a7",
"primaryId": "",
"info1": "",
"info2": ""
}
}

Response Code

Status CodeStatusMessage
0x0200SUCCESSTRANSACTION SUCCESSFULL
0x0201UNAUTHORIZEDUNAUTHORIZED USER
0x0202FAILUREFAILURE USER
0x0203MISSING_PARAMETERMISSING PARAMETER
0x0204CONNECTION_TIMEOUTCONNECTION TIMEOUT
0x0205SOMETHING_WENT_WRONGSOMETHING WENT WRONG
0x0206PENDINGTRANSACTION PENDING
0x02082FATWO FACTOR AUNTHENTICATION