Geoswift Remittance Query Interface

Description

look up the status and details of a remittance.

Interface endpoint

https://api.geoswift.com/ofr/remitOrder/query

Name Type& Max Description Requirement
merchantId varchar(9) The unique identity of the merchant in Geoswift system. M
requestId varchar(50) Uses requestId to query about the status of a remittance. 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

Sample

{ "hmac": "LPtehd0R2bipVMTFpUV8ek5Ww2QBLkkGQ5BQz+1rNeo8H84nH3WCBGN o2S34wWl7kGW/RqS62eUr40jTBLEpdDHYqMwhuXg/iPT5OysbqRs4Y7525joDxup LNu1fSyXd7mAWJfQBg+FAgiVOyGbPH6wAnsiBjPW+3hVLZ6xigqra5gRibayMyNd kCUzSeJ4zKwQIKZhbuBN1yC8wMtY0yaocVqUvOBQabqvqJ3XZv0kBMhtKh2+M5G5 JFoody10klqAshL/ws/syvFB/35lSuJAaegEVh66MbqpAFanopzRSZV66jhOUbUk 9JH6g76lO/HG5Ranl7RkHeGSAbrgwng==", "merchantId": "896666110", "requestId": "1719899240294" }

Returned Parameter Fields

Name Description
merchantId The unique identity of the merchant in Geoswift system.
requestId The request ID
serialNumber Serial number of the remittance in Geoswift system
quotationId The unique identifier of quotation
quotationType The type of quotation:
ORIGINAL
TARGET
status The request status:
SUCCESS
ERROR
orderStatus The remittance status:
INIT
PROCESS
SUCCESS
FAILED
REVERSED
CANCELING
CANCELED
originalAmount Original remittance amount; UNIT: Cent
originalCurrency Original remittance currency.
Refer to "Currency List"
targetAmount Target remittance amount.UNIT: Cent
targetCurrency Target remittance currency
Refer to "Currency List"
rate FX rate, with eight reserved decimal places
errorMessage The error information, returned when the orderStatus is FAILED
errorCode The error code, returned when the orderStatus is FAILED
completeDateTime The remittance completion time, returned when the orderStatus is SUCCESS or FAILED. Beijing time,format: yyyy-mm-dd hh:mm:ss
reversalDateTime The time when the fund is refunded by bank,returned when the orderStatus is REVERSED. Beijing time,format: yyyy-mm-dd hh:mm:ss
partnerId Same as the request parameter
hmac The result of parameter signature,generated by Geoswift.For the signature verification process,please reference to "Geoswift encryption and decryption process specification"

Sample

{ "completeDateTime": "2024-07-02 14:39:45", "errorCode": "EZ000313", "hmac": "gvLYUONZPtLq0qRavb9vEToeNFxmjBJIigUn5kTLHTFdZA0TpRuJ1P4 qmaUu7lz0SpvTNtn6Met5ng/zN0sLPJGRU9VgRW58j4SBhs4x//u7WxH44eTGXon 2MiZybuv4BfmcYeubb4RWlTW965Nlkrh8OMUtjD4rhq/WosQndyIHEMAIi2Peb+O mUSRuAXWWDsubxoQhIxO68eR0GARtaQF/6TEca3ZeLIqYxaXRi+x+HXH+RX6gVG0 QR25R7GUoshgkGIkH8+ZTKnpDJGixJhwAMEkU1q65lFRF2UrwqPUgPKnagk7QwCh Y/9EHQqxK2z3Z2UtNPys4sGd0vbJgcg==", "merchantId": "896666110", "orderStatus": "FAILED", "originalAmount": "100", "originalCurrency": "USD", "quotationId": "", "quotationType": "TARGET", "requestId": "1719899240294", "serialNumber": "20240702844835992801758386388992", "status": "SUCCESS", "targetAmount": "100", "targetCurrency": "USD" }