退款查询

功能概述

商户通过杰易收退款订单查询接口查询汇元通平台的订单退款交易明细。商户通过主动查询订单获知订单退款信息。

接口地址

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":"G90008005", "requestId":"2c9980727a31dfd6017a32560ccd0009", "hmac":"Y1pf4jdnV/oYuLUBBYOM5cRPpwpotnMaMxB8O91ihqjXtTIZ6dJkgz945KgTQ+w +5pbLtGBqbzjB11HzywKMOZw03JHdlOc/v8ptVNz5yUPGQ2qdDdY6tH1atnFzhtKK7LR8fcz/ Dizth4DR8Aq4dyB+uV+UNNVJGmEDIdmFAYpGp78J3hBgDjImCMUiV2+7b+jLX/acIosiT1P XjN9kSaHlRzTjz/gfb6DfaypIbp2LpdFzy4OUPIpyXLXbjQRSS652dAMLIArbhszKtUNmvo3Zi NipxOVoDIW/2RGiWBsaFbWM5Jl+X0Sgp2EOvxQ3gRzViVVqVkicWYTQ531+/g==" }

退款查询同步返回参数列表

参数名称 参数中文名称 参数说明
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 参数签名 汇元通生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "actualRefundAmount": "101", "actualRefundCurrency": "USD", "amount": "101", "completeDateTime": "2021-06-22 14:10:33", "currency": "USD", "merchantId": "G90008005", "remark": "核查拒绝自动退款", "requestId": "2c9980727a31dfd6017a32560ccd0009", "serialNumber": "1624342134096", "status": "SUCCESS", "hmac": "juhgRm/EpquYBqPwW+nMx+Frjxeyi1SZNwOsDkGGb7ytPI2owTHprugBrG5OiJjld8bSH nMHpb+MlnlXyxXZ1JYUxxwdWfSk9PTNbkdG5cp7DcM0V/Q+vj198+pHSzcd+sisuUzzFs/pK3zXZ3K Y4nj5rP8UvqAPnHAsUa5XOxwjF1LabwL8FsPcclnsnop15K11ZGSWfaG0VMKZ6+CjZvIYI/EOqJhS/ wgcDVCjFnSscieQb4y8QbmxzZBvOWFWbnHpua6GKxl19DAi08Qcr1n87sX9rfWRkJgKxOD6ZXsJi0+ Fmsk8S+mgxUhhe0LXZR9XvxzOnCOyvjURCBu+tA==" }