Quick Pay

POST/v3/payment/quickpay

What is this?

Quick Pay lets merchants accept payments by scanning a QR code presented by the customer. The customer scans the merchant's QR code using their preferred payment app, and the payment is processed instantly.

When to Use

Use Quick Pay when you want to:

• Accept in-store payments via QR code
• Process offline transactions at a physical store or terminal
• Support multiple e-wallets and payment methods in a single integration

Quick Pay is an offline payment method. Its subscription rate is based on the offline subscription plan. Contact support@revenuemonster.my to activate this feature.

How to Use

1. Customer presents a QR code from their payment app
2. Scan the QR code to get the authCode
3. Send the authCode along with order details to this endpoint
4. Check the code in the response — if "SUCCESS", the payment is complete

---

Standard Quick Pay

Request Parameters

authCodeStringrequired

Auth code of QR code/barcode being scanned

ipAddressStringrequired

IP address of terminal/application for payment

storeIdStringrequired

Revenue Monster Store ID

order.idStringrequired

Order ID

order.titleStringrequired

Order Title

order.currencyTypeStringrequired

Order Currency Type (currently supported MYR only)

order.amountUint64required

Order Amount

order.detailString

Order Detail

order.additionalDataString

Order Additional Data

Example Request

JSON

1{
2  "authCode": "134850717797247290",
3  "storeId": "6170506694335521334",
4  "ipAddress": "8.8.8.8",
5  "order": {
6    "id": "ODR-20230513-1001",
7    "title": "Payment via OpenAPI",
8    "currencyType": "MYR",
9    "amount": 1000,
10    "detail": "",
11    "additionalData": ""
12  }
13}

Response Parameters

itemObject

Transaction response object

codeString

"SUCCESS" if the payment succeeded, otherwise an error code

error.codeString

Error code if the request failed

error.messageString

Error message if the request failed

error.debugString

Debug message (sandbox only)

---

Quick Pay + Voucher

Vouchers can be generated as QR codes for scanning. Scan the voucher QR code first, then scan the wallet QR code.

Request Parameters

authCodeStringrequired

Auth code of QR code/barcode being scanned

ipAddressStringrequired

IP address of terminal/application for payment

storeIdStringrequired

Revenue Monster Store ID

order.idStringrequired

Order ID

order.titleStringrequired

Order Title

order.currencyTypeStringrequired

Order Currency Type (currently supported MYR only)

order.amountUint64required

Order Amount

order.detailString

Order Detail

order.additionalDataString

Order Additional Data

voucher.codeString

Revenue Monster Voucher Code

Example Request

JSON

1{
2  "authCode": "134850717797247290",
3  "storeId": "6170506694335521334",
4  "ipAddress": "8.8.8.8",
5  "order": {
6    "id": "ODR-20230513-1001",
7    "title": "Payment via OpenAPI",
8    "currencyType": "MYR",
9    "amount": 1000,
10    "detail": "",
11    "additionalData": ""
12  },
13  "voucher": {
14    "code": "haYkAch3VN"
15  }
16}

Response Parameters

itemObject

Transaction response object

codeString

"SUCCESS" if the payment succeeded, otherwise an error code

error.codeString

Error code if the request failed

error.messageString

Error message if the request failed

error.debugString

Debug message (sandbox only)

---

Quick Pay + Spending Loyalty

You will receive extra parameters in the transaction response. You need to print the generated QR code on the receipt so customers can use their loyalty program to retrieve spending loyalty points.

See Transaction Object > Spending Loyalty

Request Parameters

authCodeStringrequired

Auth code of QR code/barcode being scanned

ipAddressStringrequired

IP address of terminal/application for payment

storeIdStringrequired

Revenue Monster Store ID

order.idStringrequired

Order ID

order.titleStringrequired

Order Title

order.currencyTypeStringrequired

Order Currency Type (currently supported MYR only)

order.amountUint64required

Order Amount

order.detailString

Order Detail

order.additionalDataString

Order Additional Data

loyalty.typeString

Loyalty type

loyalty.memberIdString

Loyalty member's ID

loyalty.countryCodeString

Loyalty member's country code

loyalty.phoneNumberString

Loyalty member's phone number

Example Request

JSON

1{
2  "authCode": "134850717797247290",
3  "storeId": "6170506694335521334",
4  "ipAddress": "8.8.8.8",
5  "order": {
6    "id": "ODR-20230513-1001",
7    "title": "Payment via OpenAPI",
8    "currencyType": "MYR",
9    "amount": 1000,
10    "detail": "",
11    "additionalData": ""
12  },
13  "loyalty": {
14    "type": "PHONENUMBER",
15    "countryCode": "60",
16    "phoneNumber": "103403660"
17  }
18}

Response Parameters

itemObject

Transaction response object

codeString

"SUCCESS" if the payment succeeded, otherwise an error code

error.codeString

Error code if the request failed

error.messageString

Error message if the request failed

error.debugString

Debug message (sandbox only)

---

Quick Pay + Membership Card

Currently available membership card: Alipay Gourmet Card (马来西亚美食优惠卡).

Verify Membership Card

Request Parameters

memberCardIdStringrequired

Alipay's Member Card ID

storeIdStringrequired

Store ID

Example Request

JSON

1{
2  "memberCardId": "28158443195878043074",
3  "storeId": "4949529109748431621"
4}

Response Parameters

codeString

"SUCCESS" if the verification succeeded, otherwise an error code

error.codeString

Error code if the request failed

error.messageString

Error message if the request failed

error.debugString

Debug message (sandbox only)

---

Quick Pay

Request Parameters

authCodeStringrequired

Auth code of QR code/barcode being scanned

ipAddressStringrequired

IP address of terminal/application for payment

storeIdStringrequired

Revenue Monster Store ID

order.idStringrequired

Order ID

order.titleStringrequired

Order Title

order.currencyTypeStringrequired

Order Currency Type (currently supported MYR only)

order.amountUint64required

Order Amount

order.detailString

Order Detail

order.additionalDataString

Order Additional Data

extraInfo.typeString

Extra Type "MEMBERSHIP"

extraInfo.referenceString

Membership Card ID

Example Request

JSON

1{
2  "authCode": "134850717797247290",
3  "storeId": "6170506694335521334",
4  "ipAddress": "8.8.8.8",
5  "order": {
6    "id": "ODR-20230513-1001",
7    "title": "Payment via OpenAPI",
8    "currencyType": "MYR",
9    "amount": 1000,
10    "detail": "",
11    "additionalData": ""
12  },
13  "extraInfo": {
14    "type": "MEMBERSHIP",
15    "reference": "28158443195878043074"
16  }
17}

Response Parameters

itemObject

Transaction response object

codeString

"SUCCESS" if the payment succeeded, otherwise an error code

error.codeString

Error code if the request failed

error.messageString

Error message if the request failed

error.debugString

Debug message (sandbox only)