核查查询接口
功能概述
商户通过杰易收核查查询接口查询在汇元通平台提交的核查订单信息。
接口地址
https://apis.geoswift.com/overseas/inspect/query
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
商户在汇元通系统的唯一身份标识，商户完成汇元通系统注册后可登录商户后台商户服务查看。 |
M |
| partnerId |
服务商 ID |
varchar(9) |
服务商编号 |
C |
| serialNumber |
原交易流水号 |
varchar(32) |
原交易流水号 |
M |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
M |
参数示例
<![CDATA[
{
"merchantId":"G90008005",
"serialNumber":"2c9980727a2c6c68017a2dcb60c90082",
"hmac":"PC2txSSYdLrirc0U3oP55nceceklyqdTFZcJzyVfRWLEmxkJGYBd0omjIB2PnoqPx6UW
+g5KHvks3QXz9s+aO4O6b9UJtJJk4zCyDAzC13mKm9YrT1x3X3NW3lgIRYWAYS1MGCf7jLJ0lTCYo
2Zw/wYsPZjJMRaPLcS7AjZGJl44IHv98x6hN70SauY8e3v2eb/+Ily81aySizSCgisbQphwzmz/59
2/u2ecLCKtoQS4HjEHRRMrHGbRpsK1EUEJ1OXtxf4HDzrYeVkkdVM8PmCspZCw6Z5Hli6Brni+JI1
TH0hCvYHoZuybrC+Dz19fBIUfiSlTrGTwLft54qQDvQ=="
}
]]>
核查查询返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| merchantId |
商户编号 |
商户编号 |
| partnerId |
服务商ID |
服务商编号 |
| serialNumber |
原交易流水号 |
原交易流水号 |
| refundBankRequestNumber |
核查退款的渠道请求号 |
等同退款同步/异步返回的bankRequestNumber;基于产品配置,当核查退款参数isRefund为true时,返回此参数 |
| status |
请求状态 |
SUCCESS 成功 |
| FAILED 失败 |
| ERROR 错误 |
| inspectStatus |
核查结果 |
NOT_NEED 无需核查 |
| INIT 初始化 |
| PROCESSING 核查中 |
| SUCCESS 核查通过 |
| REFUSE 核查不通过 |
| inspectRemark |
核查结果说明 |
核查不通过后才会返回 |
| isRefund |
核查退款 |
true 是 |
| false 否 |
| 核查不通过后才会返回 |
| refundCompleteTime |
退款完成时间 |
基于产品配置,当核查退款参数isRefund为true时,返回此参数 |
| inspectRefundStatus |
核查退款状态 |
COMPLETED 已完成 |
| INCOMPLETE 未完成 |
| NOT_NEED 无需退款 |
| uploadTime |
完成时间 |
完成时间 |
| remark |
备注 |
备注 |
| hmac |
参数签名 |
汇元通生成的参数签名结果，验签过程请参考解密流程 |
示例
<![CDATA[
{
"inspectStatus": "PROCESSING",
"merchantId": "G90008005",
"serialNumber": "2c9980727a2e129e017a319cbfb20025",
"status": "SUCCESS",
"uploadTime": "2021-06-22 10:49:19",
"hmac": "suawPxpRfd60f4aUdbDvUSQ15mh1UG5ftGA7CAJu5/PGOgRjJcdpavnuH4cG5sqa9V
Z6dIALbuQHkrVGia41wF6mppqvJM450PqXzMKyiid9jPpiCCvhegeSIehN1toKvVAS3alZXeWjI
HVqEPmkFsDfdn5RrUS4t0IhUGuv66R4SUoLKG01LowoaFXCoLBAfmwOj8qPnQMqDoFszgJMtAMI
9ML8fES/c6mSgLlrEC9AdW/z1Oa/XgM6XScOaaN0KHxm+embvWGQ/eUY+QnF/DcsWNqp3ysvuQ9
ZrooBl/MxHavAPMuxr4tAfejHaFY//iIt7tlzo+pBn1rS5FPuJw=="
}
]]>