Create the quotation
https://api.geoswift.com/ofr/quotation/order
| Name | Type & Max | Description | Requirement |
|---|---|---|---|
| merchantId | varchar(9) | The unique identity of the merchant in Geoswift system | M |
| requestId | varchar(50) | The requestId is an ID generated by the merchant. This ID is unique for each merchant and can be used for ensuring the uniqueness of the request. If the ID has been used previously, the system will respond "order already exists" | M |
| originalCurrency | - | Original remittance currency Refer to “Currency List.” |
M |
| originalAmount | long(18) | Original remittance amount.It is required when the quotationType is ORIGINAL. UNIT is in cents | C |
| targetCurrency | varchar(3) | Target remittance currency Refer to “Currency List” |
M |
| targetAmount | long(18) | Target remittance amount.It is required when the quotationType is TARGET. UNIT is in cents | C |
| payerType | - | The payer type: | O |
| INDIVIDUAL | |||
| COMPANY | |||
| payeeType | - | The payee type: | O |
| INDIVIDUAL | |||
| COMPANY | |||
| quotationType | - | The quotation type: | M |
| ORIGINAL | |||
| TARGET | |||
| tenor | - | The tenor date: | M |
| TODAY（Real time） | |||
| TOM(T+1) | |||
| SPOT(T+2) | |||
| TOM and SPOT can be passed when the target currencies are USD, AUD, GBP, CAD, HKD, CNH, SGD, JPY, or EUR | |||
| includeFee | - | Service Fee: | M |
| 1 (Include remittance service fees) | |||
| 0 (Exclude remittance service fees) | |||
| Can only be set to 1 when quoting in the target currency, which must be USD, AUD, GBP, CAD, HKD, CNH, SGD, JPY, or EUR. | |||
| payeeOrgCode | varchar(50) | The code of payee organization; See "OrganCode" in the attachment | M |
| payeeOrgCountry | - | The country code of payee organization | O |
| payeeBankNo | varchar(50) | The bank account number of payee | O |
| 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 unique identity of the merchant in Geoswift system |
| requestId | The requestId |
| serialNumber | The unique identifier of quotation |
| originalCurrency | Original remittance currency |
| originalAmount | Original remittance amount.UNIT: China fen，1 Yuan=100 Fen |
| targetCurrency | Target remittance currency |
| targetAmount | Target remittance amount. UNIT is in cents |
| 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 | |
| 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. | |
| status | The response status: |
| SUCCESS | |
| ERROR | |
| 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" |