Query By Order ID

Retrieve a transaction by the Order ID you provided when initiating the payment.

tip

Store the Order ID from every payment request — you will need it to look up transactions later.

Rate Limit

3 requests per 5 seconds per access token. Exceeding this returns a 429 Too Many Requests response. Add a short delay between retries.

When to Use

▾

Use this endpoint when:

• You only know the merchant-side Order ID, not the RM Transaction ID
• Looking up a payment by your own internal order reference
• Reconciling against your e-commerce / POS system

How to Use

▾

Endpoint

GET/v3/payment/transaction/{orderId}

Step 1: Get the Order ID

▾

Use the order.id you supplied when initiating the payment.

Step 2: Send the GET Request

▾

Pass orderId as a path parameter — /v3/payment/transaction/{orderId}.

Step 3: Read the Response

▾

The item object contains the full transaction record.

---

Request Parameters

▾

idSTRINGrequired

Order ID to look up

Example: "1684743768790895"

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 request 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).

See Transaction Object for the full field breakdown of the item response.