Quick Pay + Spending Loyalty

Quick Pay that links the transaction to a loyalty member, so the customer earns spending loyalty points alongside their payment.

When to Use

▾

Use this endpoint when:

• The merchant runs a spending-loyalty program
• The customer is enrolled as a loyalty member (identified by phone number or member ID)

important

You will receive extra parameters in the transaction response. Print the generated QR code on the receipt so customers can scan it to retrieve their spending loyalty points.

See Transaction Object > Spending Loyalty.

How to Use

▾

Endpoint

POST/v3/payment/quickpay

Step 1: Identify the Loyalty Member

▾

Capture the customer's loyalty phoneNumber (or memberId) and countryCode.

Step 2: Scan the Wallet QR

▾

Capture the customer's wallet authCode.

Step 3: Send the Payment

▾

POST the authCode, order, and loyalty object to /v3/payment/quickpay. Print the returned spending-loyalty QR on the receipt.

---

Request Parameters

▾

authCodeSTRINGrequired

Auth code of QR code/barcode being scanned

ipAddressSTRINGrequired

IP address of terminal/application for payment

storeIdSTRINGrequired

Revenue Monster Store ID

orderOBJECTrequired

Order details

idSTRINGrequired

Order ID

titleSTRINGrequired

Order Title

currencyTypeSTRINGrequired

Order Currency Type (currently supported MYR only)

amountINTEGERrequired

Order Amount

detailSTRING

Order Detail

additionalDataSTRING

Order Additional Data

loyaltyOBJECT

Loyalty details

typeSTRING

Loyalty type

memberIdSTRING

Loyalty member's ID

countryCodeSTRING

Loyalty member's country code

phoneNumberSTRING

Loyalty member's phone number

Response Parameters

▾

itemOBJECT

Transaction response object

transactionIdSTRING

Revenue Monster's unique transaction ID

referenceIdSTRING

Reference ID from the payment provider

orderOBJECT

Order details

idSTRING

Order ID

titleSTRING

Order title

currencyTypeSTRING

Currency type

amountINTEGER

Order amount in cents

detailSTRING

Order detail

additionalDataSTRING

Additional data

storeOBJECT

Store details

currencyTypeSTRING

Currency type (MYR)

balanceAmountINTEGER

Remaining balance amount for initiating refund

finalAmountINTEGER

Amount after all deductions

platformSTRING

Transaction platform

typeSTRING

Transaction type

methodSTRING

Payment method

regionSTRING

Payment region

statusSTRING

Transaction status (SUCCESS, FAILED, IN_PROCESS, etc.)

transactionAtSTRING

Transaction date time (only when SUCCESS)

createdAtSTRING

Created date time

updatedAtSTRING

Last updated date time

codeSTRING

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

errorOBJECT

Error details

codeSTRING

Error code if the request failed

messageSTRING

Error message if the request failed

debugSTRING

Debug message (sandbox only)