Refund Transaction

{% raw %}

POST/v3/payment/refund

What is this?

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

Refund eligibility depends on the payment provider. Each payment method has its own refund period. If the refund period has passed, contact support@revenuemonster.my with:

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

---

How to Use

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"

refund.typeStringrequired

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

Example: "FULL"

refund.currencyTypeStringrequired

Refund currency type

Example: "MYR"

refund.amountUint64required

Refund amount in smallest currency unit

Example: 100

reasonStringrequired

Reason for the refund

Example Request

JSON

1{
2  "transactionId": "180730103903010431152179",
3  "refund": {
4    "type": "FULL",
5    "currencyType": "MYR",
6    "amount": 100
7  },
8  "reason": "Customer requested refund"
9}

Response Parameters

itemObject

Transaction response object

codeString

"SUCCESS" if the refund succeeded, otherwise an error code.

error.codeString

Error code if the request failed.

error.messageString

Error message if the request failed.

error.debugString

Debug message (sandbox only).

---

Appendix: Merchant Refund Process Online/Offline (Terminal/App/Portal)

Payment Method	Online / Offline	Same Day	Next Day	Remarks
	Online & Offline	✅	✅	Transaction over 30 days contact Revenue Monster
	Online & Offline	✅	✅	Transaction over 30 days Contact Revenue Monster
	Online & Offline	✅	✅	Transaction over 365 days contact Revenue Monster
	Online & Offline	✅	✅	If insufficient amount, contact Revenue Monster
	Online & Offline	✅	✅	Transaction over 14 days contact Revenue Monster
	Online	❌	❌	If insufficient amount, contact Revenue Monster
	Offline	✅	✅	Transaction over 30 days contact Revenue Monster
	Online	❌	❌	Contact Revenue Monster
	Offline	✅	❌	Merchant may void to customer before settlement
	Online	❌	❌	Manually refund to customer / Customer may file dispute to their bank issuer
	Online & Offline	❌	❌	Contact Revenue Monster
	Online & Offline	❌	❌	Contact Atome at support@atome.my
	Online & Offline	✅	❌	Merchant may void to customer before settlement

Note: Same wallet with sufficient amount

For refund requests, contact support@revenuemonster.my.

{% endraw %}