Order Query Interface

description

This interface is provided to merchants to query the status of orders.

Request Endpoint

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

Sample

{ "merchantId": "890000595", "requestId": "1527746602492", "hmac": "fHFew+2Kbo/qoJwIAyfM26fNY36xg0Qy1NNg3Q362aoxJxT4RqrJIk88Nlt+10p67uLp39ESF9 oV+yZu4M3Mvb0LG6iUGtz07uWsjzjVyd1hwuIvP++pXKK5zpYSGN/YO48M2R9dR6/bIu2tfZ gv4wx8UR037tKezt27WtImvGRFTPFJys1D0wSg8//oQeagSMZfUUgxN05Eoqkt//EKwTsrb9rF7 kjlpct1Dwy3f0cjtyJVkF4n4bA8qwOykH7/AxVLNUncxgkd+xHASctz2Ap5djTzfEJhsrQHX6Z0I 5BJ9H0q/fUx5xYU4Pw/hhPP4qO5IOi2dBdW1f0NP+Fqgw==" }

Response Parameter Fields

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
hmac The result of parameter signature,generated by Geoswift.For the signature verification process,please reference to "Geoswift encryption and decryption process specification"

Sample

{ "amount":"8700", "requestCreditedAmount": "",     "businessStatus":"SUCCESS",     "completeDateTime":"2020-09-23 17:26:38",     "creditedAmount":"55320",     "creditedCurrency":"CNY",     "currency":"USD",     "feeAmount":"870",     "feeCurrency":"USD",     "hmac":"ifEdXNhReYveAxL7ntTr/ct8wPa4kkiBnLpIz0COB3AOGlhNz/q613 joBS2MpTJv3fMLeH/6B4lyFlkyoPBpMdxCME20kbV22e6NZonzyRqiWmczwESnF8o7 d6wSc1UZZxoEVbRmqCPL+OzN/8yTK+1+lcOZ+DLq4tP679hp42K/TKBX+9P9Z7W/67 yEU2DMqwHmG4Kb2ep6q6r05AQmyoymvZlD9uwuHWxe6NM/+cRL++vvTOZ1UMqt6tNr n7BFTmc7+btaMEQ16awuLQ4AVN2zzAyrkPuKtPRWhWqp5XFhETyhtMunOe4UQPlK0I jepPZfPWX9vuICbJLAXGBEVw==",     "merchantId":"G10000014",     "payerCountry":"AF",     "rate":"68065191",     "requestId":"1600853181782",     "serialNumber":"2c9777f774afdb6b0174ba4912ee000c",     "status":"SUCCESS",     "tradePostscript":"" }