Skip to main content

Refund Transaction

Refund returns funds to the customer — based on the payment provider's policy and time limits.

info

Refund eligibility depends on the payment provider. Each payment method has its own refund period. If the refund period has passed, contact [email protected] with:

  • Transaction ID
  • Reference ID (if applicable)
  • Total Transaction Amount
  • Total Refund Amount
  • Reason for refund

How to Use

Endpoint
POST/v3/payment/refund

Step 1: Get the Transaction ID

Locate the transactionId from the original transaction.

Step 2: Prepare the Refund

Prepare the refund amount and reason.

Step 3: Make the Request

Send the refund request. Check the code field in the response — if "SUCCESS", the operation completed.


Request Parameters

transactionIdSTRINGrequired

Transaction ID to refund

Example: "180730103903010431152179"

refundOBJECTrequired

Refund details

typeSTRINGrequired

Refund type (e.g., "FULL")

Example: "FULL"

currencyTypeSTRINGrequired

Refund currency type

Example: "MYR"

amountINTEGERrequired

Refund amount in smallest currency unit

Example: 100

reasonSTRINGrequired

Reason for the refund

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