汇款查询接口

功能描述

 查询汇款的状况和详细信息。

接口地址

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

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

参数示例

{ "hmac": "LPtehd0R2bipVMTFpUV8ek5Ww2QBLkkGQ5BQz+1rNeo8H84nH3WCBGNo2S34 wWl7kGW/RqS62eUr40jTBLEpdDHYqMwhuXg/iPT5OysbqRs4Y7525joDxupLNu1fSyXd7 mAWJfQBg+FAgiVOyGbPH6wAnsiBjPW+3hVLZ6xigqra5gRibayMyNdkCUzSeJ4zKwQIKZ hbuBN1yC8wMtY0yaocVqUvOBQabqvqJ3XZv0kBMhtKh2+M5G5JFoody10klqAshL/ws/s yvFB/35lSuJAaegEVh66MbqpAFanopzRSZV66jhOUbUk9JH6g76lO/HG5Ranl7RkHeGSA brgwng==", "merchantId": "896666110", "requestId": "1719899240294" }

查询返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 商户在Geoswift系统中的唯一身份
requestId 订单号 订单号
serialNumber 流水号 在Geoswift系统中的流水号
quotationId 牌价ID 牌价的唯一标识符
quotationType 牌价类型 ORIGINAL 源汇款币种牌价
TARGET 目标汇款币种牌价
status 状态 SUCCESS 成功
ERROR 失败
orderStatus 汇款状态 INIT 初始化
PROCESS 处理中
SUCCESS 成功
FAILED 失败
REVERSED 撤销(退款)
CANCELING 取消中
CANCELED 已取消
originalAmount 源汇款金额 源汇款金额;单位: 分
originalCurrency 源币种 源币种
targetAmount 目标汇款金额 目标汇款金额;单位: 分
targetCurrency 目标币种 目标币种
rate 汇率 汇率,小数点后保留8位
errorMessage 错误信息 当orderStatus为FAILED时返回
errorCode 错误编码 当orderStatus为FAILED时返回
completeDateTime 汇款完成时间 汇款完成时间; 当orderStatus为SUCCESS或FAILED时返回; 北京时间; 格式为yyyy-mm-dd hh:mm:ss
reversalDateTime 撤销(退款)时间 当orderStatus为REVERSED时,银行将资金退回的时间。北京时间,格式为yyyy-mm-dd hh:mm:ss
partnerId 服务商编号 同请求参数
partnerCommissionFeeType 返佣计费模式 同汇款请求接口请求参数
partnerCommissionFeeValue 返佣计费内容 同汇款请求接口请求参数
partnerCommissionAmount 返佣金额 单位为分,不会为小数
hmac 参数签名 汇元通生成的参数签名结果,验签过程请参考解密流程

示例

{ "completeDateTime": "2024-07-02 14:39:45", "errorCode": "EZ000313", "hmac": "gvLYUONZPtLq0qRavb9vEToeNFxmjBJIigUn5kTLHTFdZA0TpRuJ1P4qmaUu7lz 0SpvTNtn6Met5ng/zN0sLPJGRU9VgRW58j4SBhs4x//u7WxH44eTGXon2MiZybuv4BfmcYeu bb4RWlTW965Nlkrh8OMUtjD4rhq/WosQndyIHEMAIi2Peb+OmUSRuAXWWDsubxoQhIxO68eR 0GARtaQF/6TEca3ZeLIqYxaXRi+x+HXH+RX6gVG0QR25R7GUoshgkGIkH8+ZTKnpDJGixJhw AMEkU1q65lFRF2UrwqPUgPKnagk7QwChY/9EHQqxK2z3Z2UtNPys4sGd0vbJgcg==", "merchantId": "896666110", "orderStatus": "FAILED", "originalAmount": "100", "originalCurrency": "USD", "quotationId": "", "quotationType": "TARGET", "requestId": "1719899240294", "serialNumber": "20240702844835992801758386388992", "status": "SUCCESS", "targetAmount": "100", "targetCurrency": "USD" }