Skip to main content

Topup Balance Offline ( QuickPay )

Method : POST
URL : https://open.revenuemonster.my/v3/loyalty/member/:memberId/topup-offline
Sandbox URL : https://sb-open.revenuemonster.my/v3/loyalty/member/:memberId/topup-offline

note

Specify loyalty member id to topup using quickpay

Request Parameters

ParameterTypeRequiredDescriptionExample
authCodeStringYesAuth code of QR code/barcode being scanned. Length: 18"134850717797247290"
orderObjectYesObject of order(Refer to explanation below)
storeIdStringYesID of the store"6170506694335521334"
memberIdStringYesMember id"1626838502220135674"

Order object (order):
ParameterTypeRequiredDescriptionExample
idStringYesOrder ID (from Merchant), max: 24"134850717797247290"
currencyTypeStringYesCurrency notation (currently only support MYR)"MYR"
amountUintYesAmount of order in cent (min RM 0.10 or amount: 10)100

Example Request

curl --location --request GET "{{open_base_path}}/v3/loyalty/member/:memberId/topup-offline" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjIwMTgtMy0xOCIsInR5cCI6IkpXVCJ9.eyJhdWQiOlsiYXBpX2NsaWVudEBFaGNLQzA5QmRYUm9RMnhwWlc1MEVQZUEyYXJ4dk1PSUZnIl0sImV4cCI6MTU5MzU4MDY0NSwiaWF0IjoxNTkwOTg4NjQ1LCJpc3MiOiJodHRwczovL29hdXRoLnJldmVudWVtb25zdGVyLm15IiwianRpIjoiRWh3S0VFOUJkWFJvUVdOalpYTnpWRzlyWlc0UXMtNnI5LVgzbElvVyIsIm5iZiI6MTU5MDk4ODY0NSwic3ViIjoiRWhRS0NFMWxjbU5vWVc1MEVMUF9wNlNKNnFQN0ZSSVFDZ1JWYzJWeUVPaXZfb1dKNnFQN0ZRIn0.RKtXykw3y0ov3mKKa_K2h5FZB2jXtqf3gNRwwnzzA4xTMdY09mEHlFupMeUmchFW2XHYK254LdMYbF4ZhjxK9K51UUdQBYH-zZpo0WWtPSZqrPGtT-c4z_sEO73EDVcek3rDwyWiXvjSKDpsZM7NOdKRm5tvT3qNK-7C7WMUjSXDcBzbTFhwfOAOO1n-wMR9H_w0DuIE-yMjEZkOdt7GUIBC8F5izATlZH0FRTx4VAwQWY4gjjQ9-3PbUbHx-NKiFXwCOAsxu-79PiF0HDEHb6ZOCGywNmKuanEXqLonli0caZiUZfrdT53y3Xnd3W2SEr6s7ZQxWnQO5PeOU7BQYA" \
--header "X-Signature: sha256 bFGc2JOEFqdI91DE5VXYBUllr+9DHcrrylRFU3i1r72aPmJreljn0dU+nwPSwTH/dTQUiZ9C2aQSF8AuT959EW4WEyEZ6VWgt9gCyZaU/bcOQ/ZIhKc06+uwzivVhAzpbUtG5tm5/sBp4ig6Sk7L6SE0Ecu6Tm0FhYl0qdgZvrTh4EEpLs3kHIuYL9QXKJILfKlu4gTX1Exrt7nNyEr8ndeUMaKYrj3FckMbRtmCwc829SsVp6FAgvoDPnguUJ+VjLF1e9NXhar2JwYjuqMkwsmUWRDbittqCgCCfaPF8anarlLsoXbdYEa7bp9BYp2U/Dw3Xd2MlamEZSR8H+Dosw==" \
--header "X-Nonce-Str: VYNknZohxwicZMaWbNdBKUrnrxDtaRhN" \
--header "X-Timestamp: 1528450585" \

Example Body Request

{
"authCode": "283838110784383199",
"storeId": "10946114768247530",
"memberId": "1626838502220135674",
"order": {
"id": "123asd1e1zz2ed",
"amount": 100,
"currencyType": "MYR"
}
}

Response Parameters

ParameterTypeDescriptionExample
itemObjectTransaction object(Refer to explanation below)
codeStringSuccessfully call this endpoint. If fail, will return error code object (Refer Appendix 1: Error Codes)"SUCCESS"

Transaction object (item):
ParameterTypeDescriptionExample
storeObjectStore object(Refer to explanation below)
referenceIdStringReference ID (from WeChat server)""
transactionIdStringTransaction ID (from RM server)"152161448229438994"
orderObjectOrder object(Refer to explanation below)
payeeObjectObject of userID made payment (payment sender){"userId": "o74f0wjjzv9eKRu1fccrZswVFnOQ"}
currencyTypeStringCurrency notation (currently only support MYR)"MYR"
platformStringCurrently only support "OPEN_API""OPEN_API"
methodStringRM currently supported methodALL
typeStringCurrently only support "QUICKPAY""QUICKPAY"
statusStringStatus returned from WeChat server"SUCCESS"
regionStringRegion of wallet, "MALAYSIA" or "CHINA""MALAYSIA"
errorString(Refer Appendix: Error Codes){}
createdAtDateTimeCreation date time of transaction"2018-03-21T06:41:22Z"
updatedAtDateTimeLast update date time of transaction"2018-03-21T06:41:22Z"

Store object (store):
ParameterTypeDescriptionExample
idStringStore ID"6170506694335521334"
nameStringStore Name"REVENUE MONSTER"
addressLine1StringStore Address 1"B-5-30, 5th Floor, Block Bougainvillea,"
addressLine2StringStore Address 2"PJU 6A, Lebuhraya SPRINT, 10 Boulevard,"
postCodeStringPostcode of store"47400"
cityStringCity of store"Petaling Jaya"
stateStringState of store"Selangor"
countryStringCountry of store"Malaysia"
countryCodeStringCountry code of store contact number"60"
phoneNumberStringPhone number of store"377334080"
geoLocationObject of [Float]Geo Location (latitude and longtitude) of store{"latitude": 3.1349857, "longtitude": 101.6136659 }
statusStringCurrent status of store"ACTIVE"
createdAtDateTimeCreation date time of store"2018-02-12T08:53:13Z"
updatedAtDateTimeLast update date time of store"2018-02-12T08:53:13Z"

Order object (order):
ParameterTypeDescriptionExample
idStringOrder ID (from Merchant), max: 24"134850717797247290"
titleStringOrder title, max: 32"Sales"
detailsStringOrder details, max: 600"1 x iPhone X; 2 x SAMSUNG S8"
amountUintAmount of order in cent (min RM 0.10 or amount: 10)100

Example Response

{
"item": {
"store": {
"id": "10946114768247530",
"name": "Ultropolis",
"imageUrl": "https://storage.googleapis.com/rm-sandbox-asset/img/store.png",
"addressLine1": "GLENMARIE LRT STATION, SS7, PETALING JAYA",
"addressLine2": "GLENMARIE LRT STATION, SS7, PETALING JAYA",
"postCode": "47301",
"city": "Petaling Jaya",
"state": "Selangor",
"country": "Malaysia",
"countryCode": "60",
"phoneNumber": "1123621544",
"geoLocation": {
"latitude": 3.0956282,
"longitude": 101.5900452
},
"status": "ACTIVE",
"createdAt": "2020-12-18T11:17:51Z",
"updatedAt": "2020-12-18T11:17:51Z"
},
"referenceId": "2021020522001472380501150230",
"transactionId": "210205115701010435429229",
"order": {
"id": "123asd1e1zz2ed",
"title": "Pay to Revenue Monster",
"detail": "[Loyalty Balance][4118165203679668885] Top Up MYR 1.00",
"additionalData": "Member ID: 1019317844027415630",
"amount": 100
},
"terminalId": "",
"payee": {
"userId": "2088622925272386"
},
"currencyType": "MYR",
"balanceAmount": 100,
"voucher": null,
"platform": "OPEN_API",
"method": "ALIPAY",
"transactionAt": "2021-02-05T11:57:14Z",
"type": "QUICK_PAY",
"status": "SUCCESS",
"region": "CHINA",
"createdAt": "2021-02-05T11:57:01Z",
"updatedAt": "2021-02-05T11:57:07Z"
},
"code": "SUCCESS"
}