Terminal — Quick Pay

Sends an e-wallet Quick Pay event to the RM Terminal. The terminal opens its camera to scan the customer's QR code and complete the payment.

When to Use

▾

Use this endpoint when:

• Accepting in-store e-wallet payments through an RM Terminal
• Driving an RM Terminal remotely from your POS or backend

tip

If your hardware device has its own scanner, use Standard Quick Pay instead for better experience and performance.

How to Use

▾

Endpoint

POST/v3/payment/terminal/quickpay

Step 1: Authenticate

▾

Obtain a valid accessToken.

Step 2: Send the Event

▾

POST the payload to /v3/payment/terminal/quickpay with type: "E-WALLET" and the terminal/order details.

Step 3: Confirm Delivery

▾

A "SUCCESS" code means the event was dispatched to the terminal. The terminal then drives the payment flow with the customer.

---

Request Parameters

▾

terminalIdSTRINGrequired

RM Terminal ID

typeSTRINGrequired

Payment type. Set to "E-WALLET".

receiptTypeINTEGERrequired

Receipt setting: 1 = Print both merchant and customer copy, 2 = Print customer copy only, 3 = Do not print

cameraTypeSTRINGrequired

Use "FRONT" or "BACK" camera to scan QR code

orderOBJECTrequired

Order details

idSTRINGrequired

Order ID

titleSTRINGrequired

Order title

currencyTypeSTRINGrequired

Currency type (currently supported MYR only)

amountINTEGERrequired

Order amount

detailSTRING

Order detail

additionalDataSTRING

Order additional data

Response Parameters

▾

transactionIdSTRING

Revenue Monster's unique transaction ID

referenceIdSTRING

Reference ID from the payment provider

terminalIdSTRING

RM Terminal ID that processed the transaction

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

idSTRING

Store ID

nameSTRING

Store name

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

payeeOBJECT

Payee details

userIdSTRING

Payee user ID

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 event was sent to terminal, 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).