报价查询接口

功能描述

 查询报价详情

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在汇元通系统的唯一id M
requestId 订单号 varchar(50) 使用requestId查询牌价的状态 M
partnerId 服务商编号 varchar(9) 二级商户上属服务商商户在汇元通系统的唯一身份标识(如果发起商户自身即为主商户此项可不传) C
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

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

返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 商户在Geoswift系统中的唯一身份
requestId 订单号 requestId
serialNumber 流水号 牌价的唯一标识符
originalCurrency 源币种 源币种: USD
originalAmount 源汇款金额 源汇款金额, 单位:(中国)分, 1元=100分
targetCurrency 目标币种 目标币种:BDT、IDR、INR、KRW、MMK、MYR、NPR、PHP、SGD、THB、VND、LKR
targetAmount 目标汇款金额 目标汇款金额, 单位:(中国)分, 1元=100分
payerType 付款人类型 INDIVIDUAL
COMPANY
payeeType 收款人类型 INDIVIDUAL
COMPANY
quotationType 牌价类型 ORIGINAL
TARGET
payeeOrgCode 收款人组织代码 收款人组织代码
payeeOrgCountry 收款人组织的国家代码 收款人组织的国家代码
payeeBankNo 收款人银行卡号 收款人银行卡号
completionTime 完成时间 牌价请求的完成时间
quotationStatus 牌价状态 SUCCESS 成功
FAILED 失败
PROCESSING 处理中
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 参数签名 汇元通生成的参数签名结果,验签过程请参考解密流程

示例

{ "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/RY 2e48eDfuolP5+OcyeGnnMLFB6Gjj2lePQ8KzpsMn6MWrizNrAeFMC2U5dDZdcaZE+0b8keHpra7c nopM4O9QHeHsyXRy46jdGinJI0ANqaSQroUOGIwbXrioVrGB0GzcX1BPQebMfKMjXsgzm1AE3H9A /f/t/qQ5lEzZnUnPm8jbyg8v5ylMvsJhtU/RZh+N24vSvrXKHauk1IoaiV9Xs2B5eN4KsVvwCMqy eBwDZSoec0lBeZ70I2q5vh7ZpUS9LlCrB2g2XmRF5FDePhg==", "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" }