Check Wallet History
Method : GET
URL : https://open.revenuemonster.my/v3/wallet/history
Sandbox URL : https://sb-open.revenuemonster.my/v3/wallet/history
Retrieve detailed wallet history including both top-ups and deductions (delivery, billing, etc.) with credit / debit movements.
When to Use
▾
Use this endpoint when:
- Building a comprehensive wallet ledger view
- Auditing wallet spend by reference type (delivery, billing, top-up)
- Filtering by transaction date range or reference type
How to Use
▾
Method: GET
URL: https://open.revenuemonster.my/v3/wallet/history
Sandbox URL: https://sb-open.revenuemonster.my/v3/wallet/history
GET with signed authentication headers. Optionally filter by cursor, transactionAt, or referenceType.
Request Parameters
▾
Cursor
Example: "60"
Transaction At
Example: ["2021-01-11T09:54:46Z", "2021-01-11T09:54:46Z"]
Reference Type
Example: "DELIVERY", "BILLING", "TOPUP_MANUAL", "TOPUP_ONLINE", "TOPUP_BANKIN""
Example Request
JSON
1curl --location --request GET "{{open_base_path}}/v3/wallet/history" \2--header "Content-Type: application/json" \3--header "Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjIwMTgtMy0xOCIsInR5cCI6IkpXVCJ9.eyJhdWQiOlsiYXBpX2NsaWVudEBFaGNLQzA5QmRYUm9RMnhwWlc1MEVQZUEyYXJ4dk1PSUZnIl0sImV4cCI6MTU5MzU4MDY0NSwiaWF0IjoxNTkwOTg4NjQ1LCJpc3MiOiJodHRwczovL29hdXRoLnJldmVudWVtb25zdGVyLm15IiwianRpIjoiRWh3S0VFOUJkWFJvUVdOalpYTnpWRzlyWlc0UXMtNnI5LVgzbElvVyIsIm5iZiI6MTU5MDk4ODY0NSwic3ViIjoiRWhRS0NFMWxjbU5vWVc1MEVMUF9wNlNKNnFQN0ZSSVFDZ1JWYzJWeUVPaXZfb1dKNnFQN0ZRIn0.RKtXykw3y0ov3mKKa_K2h5FZB2jXtqf3gNRwwnzzA4xTMdY09mEHlFupMeUmchFW2XHYK254LdMYbF4ZhjxK9K51UUdQBYH-zZpo0WWtPSZqrPGtT-c4z_sEO73EDVcek3rDwyWiXvjSKDpsZM7NOdKRm5tvT3qNK-7C7WMUjSXDcBzbTFhwfOAOO1n-wMR9H_w0DuIE-yMjEZkOdt7GUIBC8F5izATlZH0FRTx4VAwQWY4gjjQ9-3PbUbHx-NKiFXwCOAsxu-79PiF0HDEHb6ZOCGywNmKuanEXqLonli0caZiUZfrdT53y3Xnd3W2SEr6s7ZQxWnQO5PeOU7BQYA" \4--header "X-Signature: sha256 bFGc2JOEFqdI91DE5VXYBUllr+9DHcrrylRFU3i1r72aPmJreljn0dU+nwPSwTH/dTQUiZ9C2aQSF8AuT959EW4WEyEZ6VWgt9gCyZaU/bcOQ/ZIhKc06+uwzivVhAzpbUtG5tm5/sBp4ig6Sk7L6SE0Ecu6Tm0FhYl0qdgZvrTh4EEpLs3kHIuYL9QXKJILfKlu4gTX1Exrt7nNyEr8ndeUMaKYrj3FckMbRtmCwc829SsVp6FAgvoDPnguUJ+VjLF1e9NXhar2JwYjuqMkwsmUWRDbittqCgCCfaPF8anarlLsoXbdYEa7bp9BYp2U/Dw3Xd2MlamEZSR8H+Dosw==" \5--header "X-Nonce-Str: VYNknZohxwicZMaWbNdBKUrnrxDtaRhN" \6--header "X-Timestamp: 1528450585" \
Response Parameters
▾
Wallet history records
Wallet History ID
Example: "1598969381529317751"
Wallet reference ID usually is your Merchant ID
Example: "4118165203679668885"
Wallet ID
Example: "1585119930335618836"
History type (TOPUP, DEDUCT)
Example: "TOPUP"
History reference type (DELIVERY, BILLING, TOPUP_MANUAL, TOPUP_ONLINE, TOPUP_BANKIN)
Example: "TOPUP_ONLINE"
Reference about the reference type usually it's usage information
Example: "Online Transaction Topup -1598969316445167528"
How much credit added or deducted
Example: 10
Credit balance after added or deducted
Example: 1952
A sequential number
Example: 26
When history transaction
Example: "2020-09-01T14:09:41Z"
Cursor for next page
Successfully call this endpoint. If fail, will return error code object (Refer Appendix 1: Error Codes)
Example: "SUCCESS"
Example Response
JSON
1{2"cursor": "Eg13YWxsZXRoaXN0b3J5GOfBvdiL7bWAFg",3"items": [4 {5 "id": "1598969381529317751",6 "walletId": "1585119930335618836",7 "referenceId": "4118165203679668885",8 "type": "TOPUP",9 "referenceType": "TOPUP_ONLINE",10 "reference": "Online Transaction Topup -1598969316445167528",11 "credit": 10,12 "currentCredit": 1952,13 "sequenceId": 26,14 "transactionAt": "2020-09-01T14:09:41Z"15 },16 {17 "id": "1598237166700465896",18 "walletId": "1585119930335618836",19 "referenceId": "4118165203679668885",20 "type": "TOPUP",21 "referenceType": "TOPUP_MANUAL",22 "reference": "Manual Transaction Topup -1598237166252470682",23 "credit": 1200,24 "currentCredit": 1942,25 "sequenceId": 25,26 "transactionAt": "2020-08-24T02:46:06Z"27 },28 {29 "id": "1594972550536250079",30 "walletId": "1585119930335618836",31 "referenceId": "4118165203679668885",32 "type": "DEDUCT",33 "referenceType": "BILLING",34 "reference": "hi there",35 "credit": 7,36 "currentCredit": 742,37 "sequenceId": 24,38 "transactionAt": "2020-07-17T07:55:50Z"39 },40 {41 "id": "1594972542744931127",42 "walletId": "1585119930335618836",43 "referenceId": "4118165203679668885",44 "type": "DEDUCT",45 "referenceType": "BILLING",46 "reference": "hi there",47 "credit": 7,48 "currentCredit": 749,49 "sequenceId": 23,50 "transactionAt": "2020-07-17T07:55:42Z"51 },52 {53 "id": "1594954009766669631",54 "walletId": "1585119930335618836",55 "referenceId": "4118165203679668885",56 "type": "DEDUCT",57 "referenceType": "BILLING",58 "reference": "nintendo",59 "credit": 7,60 "currentCredit": 756,61 "sequenceId": 22,62 "transactionAt": "2020-07-17T02:46:49Z"63 },64 {65 "id": "1594953995593064228",66 "walletId": "1585119930335618836",67 "referenceId": "4118165203679668885",68 "type": "DEDUCT",69 "referenceType": "BILLING",70 "reference": "nintendo",71 "credit": 7,72 "currentCredit": 763,73 "sequenceId": 21,74 "transactionAt": "2020-07-17T02:46:35Z"75 },76 {77 "id": "1587103404332947270",78 "walletId": "1585119930335618836",79 "referenceId": "4118165203679668885",80 "type": "DEDUCT",81 "referenceType": "DELIVERY",82 "reference": "Delivery Charges - 1587103404863127410 (MRSPEEDY)",83 "credit": 1300,84 "currentCredit": 770,85 "sequenceId": 20,86 "transactionAt": "2020-04-17T06:03:24Z"87 },88 {89 "id": "1587103399234680991",90 "walletId": "1585119930335618836",91 "referenceId": "4118165203679668885",92 "type": "DEDUCT",93 "referenceType": "DELIVERY",94 "reference": "Delivery Charges - 1587103399697690059 (MRSPEEDY)",95 "credit": 1300,96 "currentCredit": 2070,97 "sequenceId": 19,98 "transactionAt": "2020-04-17T06:03:19Z"99 },100 {101 "id": "1587103363591085218",102 "walletId": "1585119930335618836",103 "referenceId": "4118165203679668885",104 "type": "DEDUCT",105 "referenceType": "DELIVERY",106 "reference": "Delivery Charges - 1587103363766008955 (MRSPEEDY)",107 "credit": 1300,108 "currentCredit": 3370,109 "sequenceId": 18,110 "transactionAt": "2020-04-17T06:02:43Z"111 },112 {113 "id": "1587103320158314263",114 "walletId": "1585119930335618836",115 "referenceId": "4118165203679668885",116 "type": "DEDUCT",117 "referenceType": "DELIVERY",118 "reference": "Delivery Charges - 1587103320477287218 (MRSPEEDY)",119 "credit": 1300,120 "currentCredit": 4670,121 "sequenceId": 17,122 "transactionAt": "2020-04-17T06:02:00Z"123 },124 {125 "id": "1585678546527733513",126 "walletId": "1585119930335618836",127 "referenceId": "4118165203679668885",128 "type": "DEDUCT",129 "referenceType": "DELIVERY",130 "reference": "Delivery Charges - 1585678546951971486 (MYSPEEDY)",131 "credit": 700,132 "currentCredit": 5970,133 "sequenceId": 16,134 "transactionAt": "2020-03-31T18:15:46Z"135 },136 {137 "id": "1585678500215703241",138 "walletId": "1585119930335618836",139 "referenceId": "4118165203679668885",140 "type": "DEDUCT",141 "referenceType": "DELIVERY",142 "reference": "Delivery Charges - 1585678500218585810 (MYSPEEDY)",143 "credit": 700,144 "currentCredit": 6670,145 "sequenceId": 15,146 "transactionAt": "2020-03-31T18:15:00Z"147 },148 {149 "id": "1585678499950457023",150 "walletId": "1585119930335618836",151 "referenceId": "4118165203679668885",152 "type": "DEDUCT",153 "referenceType": "DELIVERY",154 "reference": "Delivery Charges - 1585678499177927239 (MYSPEEDY)",155 "credit": 700,156 "currentCredit": 7370,157 "sequenceId": 14,158 "transactionAt": "2020-03-31T18:14:59Z"159 },160 {161 "id": "1585678087845580902",162 "walletId": "1585119930335618836",163 "referenceId": "4118165203679668885",164 "type": "DEDUCT",165 "referenceType": "DELIVERY",166 "reference": "Delivery charge - 12345",167 "credit": 700,168 "currentCredit": 8070,169 "sequenceId": 13,170 "transactionAt": "2020-03-31T18:08:07Z"171 },172 {173 "id": "1585508224750097249",174 "walletId": "1585119930335618836",175 "referenceId": "4118165203679668885",176 "type": "DEDUCT",177 "referenceType": "DELIVERY",178 "reference": "Delivery charge - 12345",179 "credit": 700,180 "currentCredit": 8770,181 "sequenceId": 12,182 "transactionAt": "2020-03-29T18:57:04Z"183 },184 {185 "id": "1585504454491935739",186 "walletId": "1585119930335618836",187 "referenceId": "4118165203679668885",188 "type": "DEDUCT",189 "referenceType": "DELIVERY",190 "reference": "Delivery charge - 12345",191 "credit": 700,192 "currentCredit": 9470,193 "sequenceId": 11,194 "transactionAt": "2020-03-29T17:54:14Z"195 },196 {197 "id": "1585503926786227184",198 "walletId": "1585119930335618836",199 "referenceId": "4118165203679668885",200 "type": "DEDUCT",201 "referenceType": "DELIVERY",202 "reference": "Delivery charge - 12345",203 "credit": 700,204 "currentCredit": 10170,205 "sequenceId": 10,206 "transactionAt": "2020-03-29T17:45:26Z"207 },208 {209 "id": "1585503925657821388",210 "walletId": "1585119930335618836",211 "referenceId": "4118165203679668885",212 "type": "DEDUCT",213 "referenceType": "DELIVERY",214 "reference": "Delivery charge - 12345",215 "credit": 700,216 "currentCredit": 10870,217 "sequenceId": 9,218 "transactionAt": "2020-03-29T17:45:25Z"219 },220 {221 "id": "1585503920670337650",222 "walletId": "1585119930335618836",223 "referenceId": "4118165203679668885",224 "type": "DEDUCT",225 "referenceType": "DELIVERY",226 "reference": "Delivery charge - 12345",227 "credit": 700,228 "currentCredit": 11570,229 "sequenceId": 8,230 "transactionAt": "2020-03-29T17:45:20Z"231 },232 {233 "id": "1585503913649332455",234 "walletId": "1585119930335618836",235 "referenceId": "4118165203679668885",236 "type": "DEDUCT",237 "referenceType": "DELIVERY",238 "reference": "Delivery charge - 12345",239 "credit": 700,240 "currentCredit": 12270,241 "sequenceId": 7,242 "transactionAt": "2020-03-29T17:45:13Z"243 }244]245}