商户通过杰易收退款订单查询接口查询汇元通平台的订单退款交易明细。商户通过主动查询订单获知订单退款信息。
https://apis.geoswift.com/cp/refundQuery
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 商户在汇元通系统的唯一身份标识,商户完成汇元通系统注册后可登录商户后台商户服务查看。 | M |
| partnerId | 服务商ID | varchar(9) | 服务商编号 | C |
| requestId | 退款订单号 | varchar(50) | 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。汇元通系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 | M |
| hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
以上参数值中不能包含以下特殊字符’”&<>()
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 商户编号 |
| partnerId | 服务商ID | 服务商编号 |
| requestId | 退款订单号 | 退款订单号,同请求参数 |
| serialNumber | 退款流水号 | 汇元通系统退款流水号 |
| bankRequestNumber | 真实银行流水号 | 请求银行流水号 |
| status | 退款状态 | INIT 初始状态 |
| SUCCESS 成功 | ||
| FAILED 失败 | ||
| amount | 退款金额 | 当退款币种为JPY、KRW、VND时,退款金额以元为单位,其他币种以分单位,1元=100分 |
| currency | 退款币种 | 见货币列表 |
| completeDateTime | 完成时间 | 完成时间 |
| remark | 备注 | 备注 |
| errorMessage | 错误信息 | 错误信息 |
| actualRefundAmount | 退款结算金额 | 退款结算金额,当退款结算币种为JPY、KRW、VND时,退款结算金额以元为单位,其他币种以分单位,1元=100分 |
| actualRefundCurrency | 退款结算币种 | 退款结算币种,见货币列表 |
| refundFeeAmount | 返还手续费金额 | 返还手续费金额,当返还手续费币种为JPY、KRW、VND时,返还手续费金额以元为单位,其他币种以分单位,1元=100分 |
| refundFeeCurrency | 返还手续费币种 | 返还手续费币种,见货币列表 |
| hmac | 参数签名 | 汇元通生成的参数签名结果,验签过程请参考解密流程 |