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
partnerCommissionFeeType Commission Fee Type. Same as the corresponding parameter in the Create Quote API request.
partnerCommissionFeeValue Commission Fee Value. Same as the corresponding parameter in the Create Quote API request.
partnerCommissionAmount Commission Amount. Unit: cent (integer only; decimal values are not supported)
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" }