post https://api.fiuu.com/RMS/API/refundAPI/q_by_refID.php
Merchant is able to do a status inquiry for a refund transaction.
Method : POST or GET
| Field Name | Data Type(Size) | M/O | Description |
|---|---|---|---|
| RefID | n(1..20) | M | Unique tracking/references ID from merchant |
| MerchantID | a(1..32) | M | Merchant ID provided by PG |
| Signature | n(1..32) | M | This is the data integrity protection hash string. |
Signature = md5( {RefID}{MerchantID}{verify_key} )
Response
PG responds JSON format to merchant upon a successful request (positive result)
| Field Name | Data Type(Size) | M/O | Description |
|---|---|---|---|
| TxnID | n(1..20) | M | Echo of merchant request |
| RefID | ans(1..100) | M | Unique tracking/references ID from merchant |
| RefundID | n(1..11) | M | Refund ID provided by PG |
| Status | enum | M | 'pending', 'processing', 'rejected', 'success' |
| LastUpdate | ans(1..255) | M | Last update timestamp. |
| FPXTxnID | ans(1..100) | O | FPX channel Transaction ID |
Appendix for Partial Refund and Partial Refund Status Inquiry
Appendix A : Data Type Details
| Code | Description |
|---|---|
| a | Letters, A-Za-z |
| n | Numbers, 0-9 |
| s | Symbols, .,?* !&.- |
| x | Fixed length x |
| y..x | Length range: y ~ x |
| y,x | Number range: 0-9, 0-9 |
Appendix B : M/O Details
| Code | Description |
|---|---|
| M | Mandatory field |
| O | Optional field. |
| C | Conditional field. |
Appendix C : Error Code & Description in JSON
Appendix C: Error Code & Description in JSON
| error_code | error_desc |
|---|---|
| PR001 | Refund Type not found. |
| PR002 | MerchantID field is mandatory. |
| PR003 | RefID field is mandatory. |
| PR004 | TxnID field is mandatory |
| PR005 | Amount field is mandatory. |
| PR006 | Signature field is mandatory |
| PR007 | Merchant ID not found. |
| PR008 | Invalid Signature. |
| PR009 | Txn ID not found. |
| PR010 | Transaction must be in authorized/captured/settled status. Current transaction is in TRANSACTION_STATUS status. |
| PR011 | Exceed refund amount for this transaction. |
| PR012 | Bank information is not applicable for credit channel transaction. |
| PR013 | BankCode not found in our database, please contact support. |
| PR014 | Bank information is mandatory for non-credit channel transaction. |
| PR015 | Server is busy, try again later. |
| PR016 | Duplicate RefID found, please provide a unique RefID. |
| PR017 | Refund request for transaction that is out of the allowed period. |
| PR018 | BeneficiaryName cannot contain non-alphanumeric characters. |
| PR019 | Refund is not allowed / Only partial refund is allowed / Only full refund is allowed. |
| PR020 | Insufficient balance to refund. |
| INQ001 | TxnID field is mandatory. |
| INQ002 | MerchantID field is mandatory. |
| INQ003 | Signature field is mandatory. |
| INQ004 | Merchant ID not found. |
| INQ005 | Invalid Signature. |
| INQ006 | Unable to find refund transaction. |
| INQ011 | RefID field is mandatory. |