Geoswift Quotation Query Interface

Description

Query the quotation details

Request endpoint

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

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

{ "requestId": "16364234661431004", "merchantId": "G30000001", "hmac": "KCiIa0OygIOjln1vzqqaw8+V4/8owsZ78RyulzotUHb3ucfT810hkCtT8G6DDnsG90K+N4MLj MvzIIelAIEYGx/mFKkl33NBnRclLEHCp/muFEE66t+n63muQygubhErwqilR/slsv5gikFqpafb6 Y0hNML1BDrEiSHDoToGeGzd7puJGhgKtul7ILCeJsfpFl+slSm2X3lpd1Mm7wQMi8XaYGNlb 8nuuG+UXYRykort+bd5kLNcx61ArYkUjzFsyYxHihvi8IX1JD7J2sgJ3e1dVxbRunojlX4RvXLx Xhf1FVYT8gOTlGn3DgRI1H+n21uzI2VOzlgnPPGBEQ3aYg==" }

Response Fields

Name Description
merchantId The unique identity of the merchant in Geoswift system
requestId The requestId
serialNumber The unique identifier of quotation
originalCurrency The original remitance currency: USD
originalAmount Original remittance amount.UNIT: China fen,1 Yuan=100 Fen
targetCurrency Target remittance currency
targetAmount Target remittance amount.UNIT: China fen,1 Yuan=100 Fen
payerType The payer type:
INDIVIDUAL
COMPANY
payeeType The payee type:
INDIVIDUAL
COMPANY
quotationType The quotation type:
ORIGINAL
TARGET
payeeOrgCode The code of payee organization
payeeOrgCountry The country of payee organization
payeeBankNo The bank account number of payee
completionTime The completion time of the quotation request; GMT time,format: yyyy-mm-dd hh:mm:ss
quotationStatus The quotation status:
SUCCESS
FAILED
PROCESSING
status The response status:
SUCCESS
ERROR
tenor Tenor Date
feeAmount Service fee amount;
Returned when includeFee is set to 1
feeCurrency Service fee currency;
Returned when includeFee is set to 1
listPrice FX rate,with eight reserved decimal places
expiredDateTime The expiry time of the quotation; Beijing time,format: yyyy-mm-dd hh:mm:ss
createDateTime The creation time of the quotation; 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

{ "completionTime": "2024-07-02 11:51:19", "createDateTime": "2024-07-02 11:51:18", "expiredDateTime": "2024-07-02 11:51:33", "feeAmount": "10", "feeCurrency": "JPY", "hmac": "yJH47B+Nvi4PoMulFl3bI/+ol/RJyOip+MrlGNxOGxx4Nt/NEvdaKy5AUk4/vJvy/RY2e48eD fuolP5+OcyeGnnMLFB6Gjj2lePQ8KzpsMn6MWrizNrAeFMC2U5dDZdcaZE+0b8keHpra7cnopM4O9QHeHs yXRy46jdGinJI0ANqaSQroUOGIwbXrioVrGB0GzcX1BPQebMfKMjXsgzm1AE3H9A/f/t/qQ5lEzZnUnPm8 jbyg8v5ylMvsJhtU/RZh+N24vSvrXKHauk1IoaiV9Xs2B5eN4KsVvwCMqyeBwDZSoec0lBeZ70I2q5vh7Z pUS9LlCrB2g2XmRF5FDePhg==", "listPrice": 109.7, "merchantId": "896666110", "originalAmount": "9", "originalCurrency": "USD", "payeeBankNo": "323423423423423", "payeeOrgCountry": "JPN", "payeeType": "INDIVIDUAL", "payerType": "INDIVIDUAL", "quotationStatus": "SUCCESS", "quotationType": "TARGET", "requestId": "17198885486236", "serialNumber": "20240702307198992759368376184832", "status": "SUCCESS", "targetAmount": "1000", "targetCurrency": "JPY", "tenor": "TODAY" }