Send OTP to Mobile API

The Send OTP to Mobile API is used to send an OTP to the customer’s mobile number.

Environment


Sandbox	https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v1/sentOtpMobile
Production	Contact your WIBMO KAM or support.

Sample request

curl --request POST \
     --url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v1/sentOtpMobile \
     --header 'X-Consumer-Custom-ID: F42BC4E7B801C834B630DE498473533F' \
     --header 'bankId: 6060' \
     --header 'clientId: 1060' \
     --header 'content-type: application/json' \
     --header 'entityId: 100' \
     --header 'secureCode: pu8gSMLNE7pNv36IlUmstU' \
     --header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
     --data '
{
  "token": "vFuvGfmW0xsk8fRWs5gavE8m2ySUlm27ccDbOsI0UDLnvhQbWZhU5KZKxnN6Mo49QTabg39m7aOM1inkXjbjrknic4W/x/CfuTHzfQpmOJu1v+hg5prI9+MzGdzNUuw3+8AX6K0SOh/FpJwdk6Yh5sv+aYuSWkfgVgb8nih+qkpLxN9tFrwujq1KS6YxA9KHiYvRq5yR/ABQfNdvK/Maw3ToUshYUksYELy9KX8JV/m1BuW8OD8SzmY9iIzLWTjthoCyEm4Kkdj5aqfe1i0UAg=="
}
'

Response parameters (Decrypted)

This API will provide a token in the response that must be decrypted using the Decrypt API. The decrypted response is similar to the following:

Parameter	Type	Parameter Requirement	Description
messageCode	numeric(4)	Mandatory	API Unique IDentifier.
clientTxnId	string(100)	Mandatory	Echoed from the request.
responseDateTime	numeric(14)	Mandatory	Response date time in the format YYYYMMDDHHMMSS with time in 24-hour format
responseCode	string(4)	Mandatory	Represents the status of the transaction.
responseMessage	string(100)	Optional	Response message based on the response code.
bankId	numeric(4)	Mandatory	Value echoed from the request header
clientId	String	Mandatory	Value echoed from header

Sample response (Decrypted)

{
  "responseCode": "00",
  "messageCode": 1941,
  "clientTxnId": "MobileOTsVdz65wadKe3RG124",
  "clientId": "1060",
  "responseDateTime": "20240814191425",
  "responseMessage": "SUCCESS",
  "bankId": 6060
}

Error codes

Error Code	Description
00	SUCCESS
1001	CARD_NOT_FOUND
1030	INVALID MESSAGE
1031	INVALID BANK ID
1032	INVALID_CLIENT_CHANNEL
1049	INVALID SECURE CODE
1052	SYSTEM_ERROR
1055	MALFORMED_REQUEST
1081	OPERATION NOT ALLOWED
1088	INVALID DATE format
1093	INVALID CLIENT TXN ID
1262	CLIENT ID NOT PRESENT
1264	BANK ID NOT PRESENT
1310	XCONSUMERKEY NOT PRESENT
1311	SECURE CODE NOT PRESENT
1320	REQUEST_DATETIME_IS_MANDATORY
1500	SYSTEM_ERROR_UNKNOWN
1501	SYSTEM_ERROR_DB

Request parameters