Merchant can request a reversal of transaction via original payment method for an “authorized” card, and “captured” card (including recurring payment), M2U, CIMB Clicks, Hong Leong Connect, Razer Pay, Alipay-Spot, POS Terminal, Boost and WeChat Pay payment.
For most of the payment channels above, the transaction can be “void” immediately on the same day before settlement (card payment at around 10pm and other channels are 11:59pm local time). For a payment channel that accepts refund requests, the transaction that happens within 180 days will be refunded within 7-14 days after the request is sent.
Please note that this API is to send a refund request, but not getting the status of the refund process. All successful requests shall be executed and if there is any exceptional case, PG support team will contact the merchant to resolve the issue.
Method: POST OR GET
| Variable / Parameter | Type Format / Max Length | Description / Example |
|---|---|---|
| txnID | integer, 20 digits | Unique transaction ID for tracking purpose. |
| domain | alphanumeric, 32 chars | Merchant ID in PG system. |
| skey | 32 chars hexadecimal string | This is the data integrity protection hash string. |
| url | optional, URL for POST response | The URL to receive POST response from PG |
| type | optional, 1-digit integer | 0 = plain text result (default), 1 = result via POST method |
Response
| Variable / Parameter | Type Format / Max Length | Description / Example |
|---|---|---|
| TranID | integer, 20 digits | Echo of the txnID in request |
| Domain | alphanumeric, 32 chars | Echo of the domain in request |
| VrfKey | 32 chars hexadecimal string | This is the data integrity protection hash string. |
| StatCode | string of 2-digit numeric | 00 = Success (will proceed the request), 11 = Failure, 12 = Invalid or unmatched security hash string, 13 = Not a refundable transaction, 14 = Transaction date more than 180 days, 15 = Requested day is on settlement day, 16 = Forbidden transaction, 17 = Transaction not found, 18 = Duplicate partial refund request, 19 = Merchant not found, 20 = Missing required parameter, 21 = Transaction must be in authorized/captured/settled status, 22 = Duplicate request is not allowed |
| StatDate | date (YYYY-MM-DD HH:mm:ss) | Response date & time |
| refundID | integer, 20 digits | Refund ID provided by PG |
Formula of skey & VrfKey
skey =md5( {txnID}{domain}{secret_key} )
VrfKey=md5( {secret_key}{Domain}{TranID}{StatCode} )Reversal Reference Table
| Payment Channel | Support Void / Refund / Both | Cut-off time for VOID request | Processing method | Credit to buyer within |
|---|---|---|---|---|
| MYR card payment | Both | 10pm GMT+8 | manual | 1-4 business day |
| Maybank2u | Refund | - | manual | 7-business day |
| CIMB Clicks | Refund | - | manual | 7-business day |
| Hong Leong Connect | Refund | - | manual | 7-business day |
| Razer Pay | Both | 11:59pm GMT+8 | auto | 1-business day |
| Alipay Spot | Both | 11:59pm GMT+8 | auto | 1-business day |
| Wechat Pay (CN, MY) | Both | 11:59pm GMT+8 | auto | 1-business day |
| Boost | Both | 11:59pm GMT+8 | auto | 1-business day |
| TnG e-Wallet | Both | 11:59pm GMT+8 | auto | 1-business day |
| Grab Pay | Both | 11:59pm GMT+8 | auto | 1-business day |
| Maybank QR Push | Refund | - | manual | 7-business day |