创建牌价
https://api.geoswift.com/ofr/quotation/order
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 商户在汇元通系统的唯一id | M |
| requestId | 订单号 | varchar(50) | requestId是由商家生成的ID。这个ID对于每个商家都是唯一的，可以用来确保请求的唯一性。如果该ID之前被使用过，系统将响应"order already exists" | M |
| originalCurrency | 源汇款币种 | - | 源汇款币种，见"币种列表" | M |
| originalAmount | 源汇款币种金额 | long(18) | 源汇款金额, 当quotationType为ORIGINAL时, 它是必填字段。单位:分 | C |
| targetCurrency | 目标币种 | varchar(3) | 目标币种， 见"币种列表" | M |
| targetAmount | 目标汇款金额 | long(18) | 目标汇款金额。当quotationType为TARGET时, 它是必填字段。单位:分 | C |
| payerType | 付款人类型 | - | INDIVIDUAL | O |
| COMPANY | ||||
| payeeType | 收款人类型 | - | INDIVIDUAL | O |
| COMPANY | ||||
| quotationType | 牌价类型 | - | ORIGINAL 源币种 | M |
| TARGET 目标币种 | ||||
| tenor | 交割期 | - | 交割期: | M |
| TODAY（实时） | ||||
| TOM(T+1) | ||||
| SPOT(T+2) | ||||
| TOM和SPOT在目标币种为USD、AUD、GBP、CAD、SGD、JPY、EUR、HKD、CNH时支持 | ||||
| includeFee | 手续费 | - | 手续费: | M |
| 1 (需包含汇款手续费) | ||||
| 0 (无需包含汇款手续费) | ||||
| 仅当目标币种报价时，且目标币种为USD、AUD、GBP、CAD、SGD、JPY、EUR、HKD、CNH时可以传1 | ||||
| payeeOrgCode | 收款人组织代码 | varchar(50) | 收款人组织代码， 见组织代码 | O |
| payeeOrgCountry | 收款人国家 | varchar(50) | 收款人组织的国家代码,见组织代码 | M |
| payeeBankNo | 收款人银行卡号 | varchar(50) | 收款人的银行账号 | O |
| partnerId | 服务商编号 | varchar(9) | 二级商户上属服务商商户在汇元通系统的唯一身份标识（如果发起商户自身即为主商户此项可不传） | C |
| partnerCommissionFeeType | 返佣计费模式 | 固定值 | FIXED固定金额 | C |
| PERCENT百分比 | ||||
| partnerCommissionFeeValue字段不为空时，partnerCommissionFeeType字段必传 | ||||
| 传递partnerid时可传此参数 | ||||
| 目标币种是USD、AUD、GBP、CAD、SGD、JPY、EUR、HKD、CNH，需要包含手续费的时候，且服务商要收返佣金额时必传，否则按不收取返佣处理 | ||||
| partnerCommissionFeeValue | 返佣计费内容 | varchar(10) | 若是按笔收取，传200，则表示每笔收2元佣金 | C |
| 若是按百分比收取，传15，则表示按到账金额的0.15%收取佣金eg.汇款金额10000USD，服务商签约费率0.2%，佣金传的0.15%， 那么该笔汇款的手续费为：10000*0.2%+10000*0.15%=35，其中15美金回定期结算到服务商资金账户。 | ||||
| partnerCommissionFeeType字段不为空时，partnerCommissionFeeValue字段必传 | ||||
| 传递partnerid时可传此参数 | ||||
| 目标币种是USD、AUD、GBP、CAD、SGD、JPY、EUR、HKD、CNH，需要包含手续费的时候，且服务商要收返佣金额时必传，否则按不收取返佣处理 | ||||
| hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 | M |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 商户在Geoswift系统中的唯一身份 |
| requestId | 订单号 | 订单号 |
| serialNumber | 流水号 | 牌价的唯一标识符 |
| originalCurrency | 源币种 | 源币种: USD |
| originalAmount | 源汇款金额 | 源汇款金额, 单位:(中国)分, 1元=100分 |
| targetCurrency | 目标币种 | 目标币种 |
| targetAmount | 目标汇款金额 | 目标汇款金额, 单位:(中国)分, 1元=100分 |
| payerType | 付款人类型 | INDIVIDUAL |
| COMPANY | ||
| payeeType | 收款人类型 | INDIVIDUAL |
| COMPANY | ||
| quotationType | 牌价类型 | ORIGINAL |
| TARGET | ||
| payeeOrgCode | 收款人组织代码 | 收款人组织代码 |
| payeeOrgCountry | 收款人组织的国家代码 | 收款人组织的国家代码 |
| payeeBankNo | 收款人银行卡号 | 收款人银行卡号 |
| completionTime | 完成时间 | 牌价请求的完成时间 |
| quotationStatus | 牌价状态 | SUCCESS 成功 |
| FAILED 失败 | ||
| status | 返回状态 | SUCCESS 成功 |
| ERROR 错误 | ||
| tenor | 交割期 | 交割期 |
| feeAmount | 手续费金额 | 包含手续费时返回 |
| feeCurrency | 手续费币种 | 包含手续费时返回 |
| listPrice | FX汇率 | FX汇率, 保留小数点8位 |
| expiredDateTime | 牌价过期日期 | 牌价过期日期 北京时间,格式为yyyy-mm-dd hh:mm:ss |
| createDateTime | 牌价创建时间 | 牌价创建时间 北京时间, 格式为yyyy-mm-dd hh:mm:ss |
| partnerId | 服务商编号 | 同请求参数 |
| partnerCommissionFeeType | 返佣计费模式 | 同请求参数 |
| partnerCommissionFeeValue | 返佣计费内容 | 同请求参数 |
| partnerCommissionAmount | 返佣金额 | 单位为分,不会为小数 |
| hmac | 参数签名 | 汇元通生成的参数签名结果，验签过程请参考解密流程 |