# 结算查询(/trade/settleResult)
该接口为平台商户通过此接口查询商户结算信息,部分通道支持
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| mid | 商户id | Long(20) | 是 | 商户进件成功后由蝉鸣分配的商户唯一ID |
| settleDate | 结算日期 | String(8) | 是 | 格式yyyyMMdd |
| outTradeNo | 平台商户交易号 | String(32) | 否 | 平台商户端交易的唯一编号,用来和蝉鸣交易关联 |
| sourceCode | 通道编码 | String(20) | 是 | ZFTGF(直付通官方通道),HF(汇付通道),ZFT(直付通K12平台),CMBCBANK(中投通道) |
返回结果:
因不同通道字段不同,返回结果以实际结果为准
当sourceCode为CMBCBANK时 中投通道返回结果:
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| totalNum | 提现总笔数 | int | 是 | |
| totalAmt | 提现总金额 | NUMBER 16,2 | 是 | |
| totalFee | 提现总手续费 | NUMBER 16,2 | 是 | |
| settleRecords | 明细数据 | array | 是 |
明细示例
流水号|交易码|商户交易日期|二级商户号|项目编号|提现金额|手续费|卡号|账户名称|提现完成时间yyyymmddhhmmss| CF20006445742023122516575875|CAS021|20231225|CM2000644575||2.00|0.00|6226111111111|张三|20231225141200| CF20006445742023122111583145|CAS021|20231221|CM2000644575||4.00|0.00|6226111111112|李四|20231225151200
其他通道返回结果:
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| mid | 商户id | Long(20) | 是 | 商户进件成功后由蝉鸣分配的商户唯一ID |
| merchName | 商户全称 | String(64) | 是 | 商户全称 |
| settleDate | 结算日期 | String(10) | 是 | 结算日期 |
| sourceCode | 支付通道 | String(20) | 是 | |
| settleAmount | 结算金额 | timestamp | 是 | 结算金额 ,单位:分 |
| serviceChargeAmount | 手续费 | String(64) | 否 | 手续费,单位:分 |
| settleBeginTime | 结算开始时间 | String(64) | 否 | 本次结算对应的结算周期的起始时间(包含此时间点),格式为yyyy-MM-dd HH:mm:ss |
| settleEndTime | 结算结束时间 | String(64) | 否 | 本次结算对应的结算周期的起始时间(不包含此时间点),格式为yyyy-MM-dd HH:mm:ss |
| status | 结算状态 | String(64) | 是 | 结算状态 0-已受理、1-处理中、2-成功、3-失败、4-退票 |
| settleTime | 结算成功时间 | String(64) | 否 | 结算成功时间,格式为yyyy-MM-dd HH:mm:ss |
| failCode | 退票状态码 | String(64) | 否 | 状态为失败或退票时的原因状态码 |
| failDesc | 退票原因 | String(64) | 否 | 状态为失败或退票时的原因 |
| dishonouredTime | 退票时间 | String(64) | 否 | 退票时间 格式为yyyy-MM-dd HH:mm:ss |
| accountType | 账户类型 | String(64) | 否 | 账户类型 |
| bankName | 银行名称 | String(64) | 是 | 银行名称 |
| bankAccountNo | 银行账户号码 | String(64) | 否 | 银行账户号码(脱敏) |
| bankAccountName | 银行账户名称 | String(64) | 否 | 银行账户名称 |
| remark | 备注 | String(64) | 否 | 备注 |