Reserve Amount from Agent's Wallet

eLoad

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

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": [ … ]
  }
}

Reserve Amount from Agent's Wallet

setSale

RequestExpand all

Responses

Was this helpful?

Request