This interface is provided to merchants to query the status of orders.
https://apis.geoswift.com/remittance/query
| Name | Type& Max | Description | Requirement |
|---|---|---|---|
| merchantId | varchar(9) | The unique identity of the merchant in Geoswift system. Merchant can log in the merchant operation and management system to check | M |
| requestId | varchar(50) | The original requestId in submitting interface | M |
| partnerId | varchar(9) | The unique identifier of the secondary merchant under the main merchant in the Geoswift system. Note: this parameter can be omitted if the initiating merchant is the main merchant. |
C |
| hmac | - | 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 |
| Name | Description |
|---|---|
| merchantId | The same as the request parameter |
| requestId | The same as the request parameter |
| serialNumber | The unique Id generated by Geoswift system |
| amount | Unit:Fen, 1 Yuan = 100 Fen |
| requestCreditedAmount | The same as the request parame |
| payerCountry | Currency source country, reference to the code list.xlsx |
| currency | EUR |
| GBP | |
| CAD | |
| SGD | |
| AUD | |
| JPY | |
| USD | |
| HKD | |
| CNY | |
| tradePostscript | Remittance postscript |
| status | SUCCESS Order submit successfully |
| ERROR The error of request or process, check the data or contact with Geoswift according to the error Message. | |
| businessStatus | INIT |
| PROCESSING | |
| FAILED | |
| SUCCESS | |
| CANCEL | |
| feeAmount | Fee amount Unit: Fen, 1 Yuan =100 Fen |
| feeCurrency | E.g., USD |
| creditedAmount | Final amount that the payer received Unit: Fen, 1 Yuan =100 Fen |
| creditedCurrency | CNY Final currency that the payer received |
| rate | List price |
| completeDateTime | E.g., 2020-09-23 17:26:38 |
| errorMsg | Error message |
| partnerId | The same as the request parameter |
| partnerCommissionFeeType |
Partner Commission Fee Type FIXED – Fixed amount per transaction PERCENT – Percentage-based commission Returned when partnerId is provided |
| partnerCommissionFeeValue |
Partner Commission Fee Value Commission value setting Returned when partnerId is provided |
| partnerCommissionAmount |
Partner Commission Amount Unit: cents (no decimal values) Returned when partnerId is provided |
| hmac | The result of parameter signature,generated by Geoswift.For the signature verification process,please reference to "Geoswift encryption and decryption process specification" |