POS Terminal Integration

Method : POST
URL :https://open.revenuemonster.my/v3/payment/terminal/quickpay
Sandbox URL : https://sb-open.revenuemonster.my/v3/payment/terminal/quickpay

note

Integrate RM Terminal with POS System or Kiosk machine (using local callback). This endpoint only supports payment initiation. For other methods (refund/reverse/settlement), please follow back refund , reverse , settlement API standard steps accordingly.

Request Parameters#

ParameterTypeRequiredDescriptionExample
transactionIdStringYesTransaction ID generated from Revenue Monster."1582107209454501456"
cameraTypeStringYesDisplay terminal Camera"FRONT"
receiptTypeUintYes1 : Print Merchant Copy and Customer copy

2 : Print Customer copy

3 : Do not print Merchant Copy & Customer Copy
1
typeStringYesReceipt E-wallet or Credit Card"E-WALLET"
orderStringYes(Refer order ){}

Order object (order):
ParameterTypeRequiredDescriptionExample
amountUintYesAmount of order in cent (min RM 0.10 or amount: 10)100
currencyTypeStringYesCurrency notation (currently only support MYR)"MYR"
idStringYesOrder ID (from Merchant), max: 24"123443333304"
titleStringYesOrder title, max: 32"title"
detailsStringYesOrder details, max: 600"desc"
additionalDataStringYesFor merchant's remark, max 128"API Test"

Example Request

curl --location --request POST "https://sb-open.revenuemonster.my/v3/payment/terminal/quickpay" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjIwMTgtMDMtMTMiLCJ0eXAiOiJKV1QifQ.eyJhdWQiOlsiYXBpX2NsaWVudEBFaGNLQzA5QmRYUm9RMnhwWlc1MEVNV1Z4NF9UbE5MZEZRIl0sImV4cCI6MTU4NjMzNzc1OCwiaWF0IjoxNTgzNzQ1NzU4LCJpc3MiOiJodHRwczovL3NiLW9hdXRoLnJldmVudWVtb25zdGVyLm15IiwianRpIjoiRWh3S0VFOUJkWFJvUVdOalpYTnpWRzlyWlc0UXlKSG9qb2VNcHYwViIsIm5iZiI6MTU4Mzc0NTc1OCwic3ViIjoiRWhRS0NFMWxjbU5vWVc1MEVKWFZ6ZDN3cmFxVE9SSVFDZ1JWYzJWeUVJeUpxSXp2eU1QVmNRIn0.FfBkCb7fjCKJdcy_DS06dKgEtcAvukPio0HyDRtH2UovhZsLFSqD_8oo21u094XSor_mqFg4hqXmLaHjX-h92Wz3kHl7OwiKQb16x8Rnl5OdyPHtMqIZqP8ab8Ch0RHEZ33VchK1zBTnG6Xosrb1B44tWqJ0_kdTtbRZN4rG821C8i4sb6sx8GaxgluJ5q7CEifMTBFJam_Jub9LfAfukq8YyIl0Bykp7B3A_su2QoELL9L_ElJdV9FuwFPHcKr9bxLvVSrEdyrFg7IBm_tJHxSl8gTh3j4b6lWZrBCfMSLraXaYRNzz1ddbVnwYD4aRuSyRmQeMYTUj0cInktnKUA" \
--header "X-Signature: sha256 GohuT2QTUXJV3MZh2OoEE9qW9wcfakOU9iVLmkTjM12NQuV6IcWMRQDz9NdxAOVIrh5MssfYCLDlafb2illXxgQMpmZkZ38NT6NQsMeMfGbHBS1Kc+BUtU7o1TMLUzk55J1tA6f0Z95oEuBlCeLm6VsgCG30wFm5YmgssJ0weIwMcW355r2sFl7QcKOuRqynoGtmmr/aGfOk1HjiFLoFzSd38O7rRjwGrekYwuYUD1N/Wp5GFXRjtaaPkzAERPbXEmnh/taLME8VeAhky6dAVGZE6gHKnP5WvvVjUE+KLtj3D32YIHzxhzEW9x3JEObqgvm5Q2oRZNxoh6/MvqwkVA==" \
--header "X-Nonce-Str: bfdgdjgtjhmnbmmjmdfdghghffj" \
--header "X-Timestamp: 1546850694" \
--data-raw {
"terminalId":"1582107209454501456",
"cameraType": "FRONT",
"receiptType": 1,
"type": "E-WALLET",
"order":{
"amount":100,
"currencyType":"MYR",
"id":"123443333304",
"title":"title",
"detail":"desc",
"additonalData":"API Test"
}
}

Response Parameters#

ParameterTypeDescriptionExample
balanceAmountUintAmount of order in cent10
createdAtDateTimeCreation date time of store"2020-02-13T07:08:56Z"
currencyTypeStringCurrency notation (currently only support MYR)"MYR"
methodStringRM currently supported method"CARD"
orderString(Refer order ){}
platformStringOnly "TERMINAL""TERMINAL"
referenceIdStringTransaction ID (from server)"00000000000791320002737201919250001"
regionStringRegion of wallet"MALAYSIA"
statusStringStatus returned from WeChat server"SUCCESS"
transactionAtDateTimeTransaction date time of store"2020-10-25T04:35:22Z"
transactionIdDateTimeTransaction ID generated from Revenue Monster."200213070856100322408442"
typeString"QUICKPAY" or "BANK_CARD""BANK_CARD"
updatedAtDateTimeLast update date time of store"2020-02-13T07:08:56Z"

Order object (order):
ParameterTypeRequiredDescriptionExample
amountUintYesAmount of order in cent (min RM 0.10 or amount: 10)10
idStringYesOrder ID (from Merchant), max: 24"201919250001"
titleStringYesOrder title, max: 32"SALE"
detailsStringYesOrder details, max: 600"XXXX-XXXX-XXXX-3121"
additionalDataStringYesFor merchant's remark, max 128"000008"

Example Response

{
"balanceAmount": 10,
"createdAt": "2020-02-13T07:08:56Z",
"currencyType": "MYR",
"method": "CARD",
"order": {
"additionalData": "000008",
"amount": 10,
"detail": "XXXX-XXXX-XXXX-3121",
"id": "201919250001",
"title": "SALE"
},
"platform": "TERMINAL",
"referenceId": "00000000000791320002737201919250001",
"region": "MALAYSIA",
"status": "SUCCESS",
"transactionAt": "2020-10-25T04:35:22Z",
"transactionId": "200213070856100322408442",
"type": "BANK_CARD",
"updatedAt": "2020-02-13T07:08:56Z"
}