Skip to main content

Quick Pay + Voucher

Quick Pay with a Revenue Monster voucher applied. The voucher's discount is deducted from the order total before processing the e-wallet payment.

When to Use

Use this endpoint when:

  • The customer has an RM voucher to redeem against the purchase
  • Combining wallet payment with merchant promotions
tip

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

How to Use

Endpoint
POST/v3/payment/quickpay

Step 1: Get the Voucher Code

Capture the voucher code from a QR scan or customer-supplied code.

Step 2: Scan the Wallet QR

Capture the customer's wallet authCode.

Step 3: Send the Payment

POST the authCode, order, and voucher.code to /v3/payment/quickpay.


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

voucherOBJECT

Voucher details

codeSTRING

Revenue Monster Voucher Code

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

terminalIdSTRING

RM Terminal ID, if processed via terminal

storeOBJECT

Store details

idSTRING

Store ID

nameSTRING

Store name

imageUrlSTRING

Store image URL

addressLine1STRING

Store address line 1

addressLine2STRING

Store address line 2

postCodeSTRING

Store postcode

citySTRING

Store city

stateSTRING

Store state

countrySTRING

Store country

countryCodeSTRING

Store contact country code

phoneNumberSTRING

Store phone number

geoLocationOBJECT

Store geolocation

latitudeNUMBER

Latitude

longitudeNUMBER

Longitude

statusSTRING

Store status

createdAtSTRING

Store creation date time

updatedAtSTRING

Store last update date time

currencyTypeSTRING

Currency type (MYR)

balanceAmountINTEGER

Remaining balance amount for initiating refund

finalAmountINTEGER

Amount after all deductions

voucherOBJECT

Voucher applied to this transaction (null if none)

keySTRING

Voucher key (internal usage)

discountAmountINTEGER

Discount amount deducted, in cents

membershipOBJECT

Membership voucher details (null if not applicable)

voucherIdSTRING

Membership voucher ID

memberIdSTRING

Member ID that owns the voucher

discountAmountINTEGER

Discount amount deducted, in cents

walletOBJECT

Wallet voucher details (null if not applicable)

discountAmountINTEGER

Discount amount deducted, in cents

grossAmountINTEGER

Gross amount before discount, in cents

salesAmountINTEGER

Sales amount after discount, in cents

platformSTRING

Transaction platform

methodSTRING

Payment method

errorOBJECT

Failure reason (present when the transaction itself failed, even though the API call succeeded)

messageSTRING

Failure reason message

Example: "Customer code expired. Please scan again."

typeSTRING

Transaction type

regionSTRING

Payment region

statusSTRING

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

transactionAtSTRING

Transaction date time (only when SUCCESS)

extendInfoOBJECT

Additional payment method-specific info

inHousePromoOBJECT

In-house promotion applied

amountINTEGER

Promotion discount amount

infoSTRING

Promotion info (null if none)

buyNowPayLaterOBJECT

Buy-now-pay-later details

isBuyNowPayLaterBOOLEAN

Whether this transaction used buy-now-pay-later

installmentMonthINTEGER

Number of installment months

cardInfoOBJECT

Card details (for card payments)

binSTRING

Card bank identification number

lastFourSTRING

Last four digits of the card

fundingMethodSTRING

Card funding method

alpha2STRING

Card issuing country (ISO alpha-2)

schemeSTRING

Card scheme (e.g. Visa, Mastercard)

approvalCodeSTRING

Card approval code

referenceNoSTRING

Card transaction reference number

issuerSTRING

Card issuing bank

paymentSourceSTRING

Source of the payment

terminalInfoOBJECT

Terminal-specific info

providerSTRING

Terminal provider

inputTypeSTRING

Terminal input type

referenceNoSTRING

Terminal reference number

invoiceNoSTRING

Terminal invoice number

sourceSTRING

Source of the transaction

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)