本接口商户用于查询子商户结算记录。
https://apis.5upay.com/settlement/record/query
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一id,可在商户后台查看 | M |
| partnerId | 服务商id | varchar(9) | 服务商在首信易系统的唯一id,可在商户后台查看 | C |
| startDateTime | 结算发起时间起始日期 | datatime | yyyy-MM-dd HH:mm:ss,起始日期与结束日期,最多相隔 30 天。 | M |
| endDateTime | 结算发起时间结束日期 | varchar(9) | yyyy-MM-dd HH:mm:ss,起始日期与结束日期,最多相隔 30 天。 | C |
| hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| partnerId | 服务商Id | 同请求参数 |
| startDateTime | 结算发起时间起始日期 | 同请求参数 |
| endDateTime | 结算发起时间结束日期 | 同请求参数 |
| total | 查询结果条数 | 查询结果条数 |
| records | 记录列表 | 见记录列表 |
| hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| amount | 结算金额 | 单位:分,1 元=100 分 |
| currency | 币种 | CNY 人民币 |
| USD 美元 | ||
| JPY 日元 | ||
| EUR 欧元 | ||
| CHF 瑞士法郎 | ||
| GBP 英镑 | ||
| CAD 加拿大元 | ||
| AUD 澳大利亚元 | ||
| HKD 港币 | ||
| settleStatus | 结算状态 | CONFIRMED 已确认 |
| WITHHOLDING 已扣款 | ||
| SETTLEMENTING 结算中 | ||
| SUCCESS 结算成功 --成功终态 | ||
| FAIL_RETURN 失败退回 -- 失败终态 | ||
| remitStatus | 打款状态 | INIT 待打款 |
| REMITING 打款中 | ||
| SUCCESS 打款成功 | ||
| FAIL 打款失败 | ||
| refundStatus | 退票状态 | 若打款发生退票,则状态为 REFUNDING:已退票 |
| startDate | 起始日期 | 统计结算金额的起始日期 yyyy-MM-dd |
| endDate | 截止日期 | 统计结算金额的截止日期 yyyy-MM-dd |
| createDateTime | 结算发起时间 | 发起结算的开始时间 yyyy-MM-dd HH:mm:ss |
| remark | 结算备注 | 在结算时记录的备注信息 |
| errorMessage | 结算失败原因 | 若结算失败会展示失败原因 |