eLoad
/
Reserve Amount from Agent's Wallet

Reserve Amount from Agent's Wallet

Reserve amount from agent's wallet for a not yet committed transaction. The SKU specified in the content will determine how the transaction will be committed.

Download OpenAPI description
setSale.json
setSale.yaml
Languages
Servers
Mock server

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

setSale

Request

Reserve amount from agent's wallet for a not yet committed transaction. The SKU specified in the content will determine how the transaction will be committed.

Bodyapplication/jsonrequired
access_tokenstring<= 500 charactersrequired
Example: "abc123xyz456"
methodstring<= 64 charactersrequired
Example: "POST"
versionstring<= 10 charactersrequired
Example: "1.0.0"
contentobjectrequired
content.​msgIdstring<= 30 charactersrequired

Unique message ID generated by a 3rd party system. Format AAAYYYYMMDDHH24MISSCCCC

Example: "0462023040123595999"
content.​channelstring<= 20 charactersrequired

Fixed value for each channel (e.g., 046 for UMB)

Example: "046"
content.​orgCodestringrequired

Organization code

Example: "ORG123"
content.​eloadNbrstring

eLoad number (optional)

Example: "10000001"
content.​userCodestringrequired

User ID used in ZSmart UPortal

Example: "USER001"
content.​passwordstringrequired

RSA encrypted password for ZSmart UPortal

Example: "rsaEncryptedPassword123"
content.​extOrderNbrstringrequired

CRM order number, unique for each setSale attempt

Example: "CRMORDER001"
content.​salesArray of objectsrequired
content.​sales[].​txnTypestringrequired

Transaction type (Payment/Deposit)

Enum"Payment""Deposit"
Example: "Payment"
content.​sales[].​skustring

SKU of the transaction (required depending on txnType)

Example: "POSTPAID"
content.​sales[].​msisdnSubstring

MSISDN of subscriber (required when sku is provided)

Example: "601112345678"
content.​sales[].​amountnumber(float)required

Transaction amount (e.g., 50.00)

Example: 50
content.​sales[].​extTxnNbrstringrequired

External transaction number, unique for each transaction

Example: "EXTTXN001"
curl -i -X POST \
  https://enterprise-iot-portal.u.com.my/_mock/eload/setsale/api/rest \
  -H 'Content-Type: application/json' \
  -d '{
    "access_token": "abc123xyz456",
    "method": "POST",
    "version": "1.0.0",
    "content": {
      "msgId": "0462023040123595999",
      "channel": "046",
      "orgCode": "ORG123",
      "eloadNbr": "10000001",
      "userCode": "USER001",
      "password": "rsaEncryptedPassword123",
      "extOrderNbr": "CRMORDER001",
      "sales": [
        {
          "txnType": "Payment",
          "sku": "POSTPAID",
          "msisdnSub": "601112345678",
          "amount": 50,
          "extTxnNbr": "EXTTXN001"
        }
      ]
    }
  }'

Responses

Reservation successful

Bodyapplication/json
res_codestring<= 10 characters

Response code (e.g., "00000" for success)

Example: "00000"
res_messagestring<= 255 characters

Response description (e.g., success message)

Example: "Operation success"
resultobject

Response result (optional).

Response
application/json
{
  "res_code": "00000",
  "res_message": "Operation success",
  "result": {
    "eloadNbr": "10000001",
    "resultCode": "DBEP0000",
    "resultMsg": "Success",
    "transactions": [ … ]
  }
}
U Mobile. 2024. All right reserved.