eLoad

/

verifyPin

Verify User PIN

Authenticates the user based on MSISDN and PIN.

Download OpenAPI description

Servers

Mock server

https://enterprise-iot-portal.u.com.my/_mock/eload/verifypin/

verifyPin

Request

Authenticates the user based on MSISDN and PIN.

Bodyapplication/jsonrequired

access_tokenstring<= 500 charactersrequired

API Gateway access token

Example: "abc123token"

methodstring<= 64 charactersrequired

API name

Example: "verifyPin"

versionstring<= 10 charactersrequired

API version

Example: "1.0"

contentobjectrequired

Refer to content for details

content.msgIdstring<= 30 characters

Unique message ID generated by third-party system.

Example: "047202504231530300001"

content.channelstring<= 20 characters

Channel identifier.

Example: "UMB"

content.msisdnstring

MSISDN of the user.

Example: "601112345678"

content.pinstring

RSA encrypted PIN for authentication.

Example: "<RSA_ENCRYPTED_PIN>"

curl -i -X POST \
  https://enterprise-iot-portal.u.com.my/_mock/eload/verifypin/api/rest \
  -H 'Content-Type: application/json' \
  -d '{
    "access_token": "abc123token",
    "method": "verifyPin",
    "version": "1.0",
    "content": {
      "msgId": "047202504231530300001",
      "channel": "UMB",
      "msisdn": "601112345678",
      "pin": "<RSA_ENCRYPTED_PIN>"
    }
  }'

Responses

Authentication result

Bodyapplication/json

res_codestring<= 10 characters

Response code

Example: "00000"

res_messagestring<= 255 characters

Response description

Example: "Operation success"

resultobject

Authentication result

Response

application/json

{
  "res_code": "00000",
  "res_message": "Operation success",
  "result": {
    "resultCode": "DBEP0000",
    "resultMsg": "Success"
  }
}