Geoswift aggregated payment refund query interface is used for merchants to query the refund details.
https://apis.geoswift.com/cp/refundQuery
| Name | Type& Max | Description | Requirement |
|---|---|---|---|
| merchantId | varchar(9) | The unique identity of the merchant ID in Geoswift system. | M |
| partnerId | varchar(9) | The unique ID of the service provider in the Geoswift system | C |
| requestId | varchar(50) | The refund order number is generated by the merchant, the order number must be the unique on the transaction platform. Request/order which had been paid or canceled in Geoswift's platform can’t be submitted with the same request ID. | M |
| hmac | varchar(500) | The result of parameter signature,generated by the merchant. For the method of obtaining hmac,please reference to "Geoswift encryption and decryption process specification" | M |
The preceding parameter values cannot contain the following special characters: '" &<>()
| Name | Description |
|---|---|
| merchantId | The unique identity of the merchant ID in Geoswift system. |
| partnerId | The unique ID of the service provider in the Geoswift system |
| requestId | The refund order number is generated by the merchant, the order number must be the unique on the transaction platform. Request/order which had been paid or canceled in Geoswift's platform can’t be submitted with the same request ID. |
| serialNumber | Serial Number of the request in Geoswift's platform |
| bankRequestNumber | Serial number for requesting bank |
| status | Refund status |
| INIT | |
| SUCCESS | |
| FAILED | |
| amount | When the currency is JPY, KRW or VND, the unit of amount is Yuan, the unit of other currencies is China Fen, 1 Yuan = 100 Fen |
| currency | Reference to the currency list table in the appendix |
| completeDateTime | Completion time |
| remark | remark |
| errorMessage | Error message |
| actualRefundAmount | Actual refund amount,when the actualRefundCurrency is JPY, KRW or VND, the unit of actualRefundAmount is Yuan, the unit of other currencies is China Fen, 1 Yuan = 100 Fen |
| actualRefundCurrency | Reference to the currency list table in the appendix |
| refundFeeAmount | Refund fee amount,when the refundFeeCurrency is JPY, KRW or VND, the unit of refundFeeAmount is Yuan, the unit of other currencies is China Fen, 1 Yuan = 100 Fen |
| refundFeeCurrency | The currecy of the refund fee; Reference to the currency list table in the appendix |
| hmac | The result of parameter signature,generated by Geoswift. For the signature verification process,please reference to "Geoswift encryption and decryption process specification" |