eLoad

/

Change User PIN

Change User PIN

Changes the user's PIN.

Download OpenAPI description

Servers

Mock server

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

changePin

Request

Changes the user's PIN based on the provided MSISDN and old PIN.

Bodyapplication/jsonrequired

access_tokenstring<= 500 charactersrequired

API Gateway access token

Example: "abc123token"

methodstring<= 64 charactersrequired

API name

Example: "changePin"

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: "046202504231530300001"

content.channelstring<= 20 characters

Channel identifier.

Example: "UMB"

content.msisdnstring

MSISDN of the user.

Example: "601112345678"

content.pinstring

RSA encrypted old PIN.

Example: "<RSA_ENCRYPTED_PIN>"

content.newPinstring

RSA encrypted new PIN.

Example: "<RSA_ENCRYPTED_NEW_PIN>"

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

Responses

PIN change result

Bodyapplication/json

res_codestring<= 10 characters

Response code

Example: "00000"

res_messagestring<= 255 characters

Response description

Example: "Operation success"

resultobject

Validation result detail.

Response

application/json

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