1. 3、业务指引
  • 1、接入指引
    • 1.1 阅读人员与名词解释
    • 1.2版本发布说明
    • 1.3接入准备
    • 1.4接入指引
  • 2、平台规范
    • 2.1接口格式定义
    • 2.2 加签验签说明与代码示例
    • 2.3 参数说明
    • 2.4上线前检查清单
  • 3、业务指引
    • 3.1 商户入网业务接入指引
    • 3.2 余额分账业务接入指引
    • 3.3 支付订单对账业务接入指引
  • 4、API列表
    • 4.1商户入网类接口
      • 4.1.1 图片上传接口
        • 4.1.1.1 公共文件上传（进件用上传临时文件）
      • 4.1.2 商户入网与配置
        • 4.1.2.1 商户添加
        • 4.1.2.2 商户更新
        • 4.1.2.3 收单商户入网
        • 4.1.2.4 收单商户更新
        • 4.1.2.5 通道添加
        • 4.1.2.6 通道变更
        • 4.1.2.7 商户详情查询
        • 4.1.2.8 收单商户更新详情查询
        • 4.1.2.9 分账开通
        • 4.1.2.10 分账变更
        • 4.1.2.11 分账开通结果查询
        • 4.1.2.12 分账关系绑定
        • 4.1.2.13 分账关系解绑
        • 4.1.2.14 微信关注配置
        • 4.1.2.15 微信关注配置查询
        • 4.1.2.16 实名认证申请
        • 4.1.2.17 实名认证申请状态查询
        • 4.1.2.18 实名认证授权状态结果查询
        • 4.1.2.19 商户入网通知
      • 4.1.3 门店管理
        • 4.1.3.1 门店添加
        • 4.1.3.2 门店更新
    • 4.2聚合支付交易类接口
      • 4.2.1 支付订单对账下载
        • 4.2.1.1 对账单下载任务创建
        • 4.2.1.2 对账单下载任务查询
        • 4.2.1.3 对账单下载任务分页查询
    • 4.3订单分账类接口
    • 4.4余额分账类接口
      • 4.4.2 余额查询接口
        • 4.4.2.1 余额查询
      • 4.4.1 余额分账相关接口
        • 4.4.1.1 B2B转账
        • 4.4.1.2 转账查询
      • 4.4.3 提现相关接口
        • 4.4.3.1 提现
        • 4.4.3.2 提现查询
        • 4.4.3.3 查询提现银行卡
    • 4.5信用付（先享后付）类接口
    • 4.6大额支付类接口
    • 4.7 资产营销类接口
      • 4.7.1 营销资产核销开放接口
        • 4.7.1.1 资产预查核验
        • 4.7.1.2 资产交易（核销）
        • 4.7.1.3 资产交易（核销）查询
        • 4.7.1.4 资产交易（核销）撤销
        • 4.7.1.5 资产交易（核销）撤销查询
        • 4.7.1.6 资产余额查询
        • 4.7.1.7 资产交易对账单拉取
        • 4.7.1.8 付款码订单轮询查询
        • 4.7.1.9 付款码订单结果通知
      • 4.7.2 品牌商户专用营销资产核销接口
        • 4.7.2.1 资产预查核验（品牌商户）
        • 4.7.2.2 资产交易（核销）（品牌商户）
        • 4.7.2.3 资产交易（核销）查询（品牌商户）
        • 4.7.2.4 资产交易（核销）撤销（品牌商户）
        • 4.7.2.5 资产交易（核销）撤销查询（品牌商户）
        • 4.7.2.6 资产余额查询（品牌商户）
        • 4.7.2.7 资产交易对账单拉取（品牌商户）
        • 4.7.2.8 付款码订单轮询查询（品牌商户）
        • 4.7.2.9 付款码订单结果通知（品牌商户）
    • 4.8辅助类接口
      • 4.8.1 开放平台API示例控制器
        • 4.8.1.1 参数加密示例
      • 4.8.2 配置获取类接口
        • 4.8.2.1 获取MCC行业类目树
        • 4.8.2.2 获取区域列表（三级联动查询）
        • 4.8.2.3 获取银行总行列表
        • 4.8.2.4 获取银行支行列表
        • 4.8.2.5 获取易宝MCC行业类目树
        • 4.8.2.6 获取易生MCC行业类目树
        • 4.8.2.7 获取易生支付宝微信MCC映射关系列表
        • 4.8.2.8 获取平安银行MCC映射关系列表
      • 4.8.3 交易投诉处理类接口
        • 4.8.3.1 投诉单分页查询
        • 4.8.3.2 投诉单详情查询
        • 4.8.3.3 回复投诉用户
        • 4.8.3.4 完结投诉处理
        • 4.8.3.5 投诉凭证图片上传
        • 4.8.3.6 投诉凭证图片查看
    • 4.9银行账户与分账类接口
      • 4.9.1 EBK账户类
        • 4.9.1.1 EBK账户注册
        • 4.9.1.2 EBK账户基本信息查询
        • 4.9.1.3 EBK账户绑定提现账户
        • 4.9.1.4 EBK账户解绑提现账户
      • 4.9.2 EBK动账交易类
        • 4.9.2.1 账户转账
        • 4.9.2.2 EBK账户提现
        • 4.9.2.3 批量清分
      • 4.9.3 EBK交易查询类
        • 4.9.3.1 转账状态查询
        • 4.9.3.2 EBK账户余额查询
        • 4.9.3.3 提现状态查询
        • 4.9.3.4 清分状态查询
  • F.附录
  • FAQ
  • 回收站
    • 平台公用信息接口
      • 获取省市区信息
      • 获取行业类目信息
      • 获取银行信息
      • 商户图片上传
    • 商户开放接口
      • 更新商户接口
      • 查询商户审核信息接口
      • 简单商户创建接口
      • 创建商户接口
    • 开放支付交易订单控制器
      • 批量更新订单业务类型
  1. 3、业务指引

3.3 支付订单对账业务接入指引

本文档为开放平台对外接入指引，用于应用方按日拉取我方对账单（交易订单明细）进行对账。
接口路径前缀：对账接口 /v1/open/dump/reconciliation，接口目录编号 4.2.1。
对账单为 异步 生成：先创建下载任务，再轮询任务查询接口获取下载地址（不提供回调通知）。
所有接口均为 POST，请求体为开放平台统一信封（requestId/timestamp/nonce/sign/reqBody），应答体为统一信封（code/msg/timestamp/sign/nonce/rspBody），签名与验签规则见「2.2」章节。

一、对账口径说明#

项目口径
对账单数据源我方交易订单（pay_trade_order），与运营端「交易订单导出」完全同源同模板
日期口径按结算时间（settle_time）取账单日当天的交易；同时限定订单创建时间在结算日往前 3 天内
交易状态口径固定包含 支付成功(1) 与 退款成功(5) 两类，不可由调用方指定
商户范围由调用方应用关联商户的商户类型自动确定，见下表
账单日期范围单日（billDate），不可跨天；最早可回溯 90 天，不支持未来日期
文件保留期任务创建后 7 天（expireTime），过期需重新创建任务
下载地址有效期10 分钟（每次查询任务重新签发签名地址），获取后请尽快下载
文件格式ZIP 压缩包，内含 1 个 xlsx 文件
金额格式交易金额/手续费/结算金额均为元，形如 1,234.89；费率字段为万分比整数
商户范围与应用商户类型的关系：
应用关联商户类型出账范围传 merchantNo 时
普通商户(1)仅本商户交易只允许传本商户编号
代理商户(2)该代理下挂全部商户的交易允许传本商户或下挂商户编号，仅出该商户交易
品牌商户(3)该品牌下挂全部商户的交易允许传本商户或下挂商户编号，仅出该商户交易
指定 merchantNo 时按单出账，不再叠加层级范围；传入非本应用下挂商户返回 12103。

二、标准对账流程#

第一步：创建下载任务（4.2.1.1）
1.
在对账日 T+1 日调用 4.2.1.1，传入 billDate（通常为前一日）。
2.
平台落一条异步导出任务并立即返回 taskId，此时 status=1（等待中）、无下载地址。
3.
幂等：同一应用、同一账单日期（含指定同一商户）在文件保留期内重复调用，返回同一个 taskId，不会重复生成文件。
第二步：轮询任务状态（4.2.1.2）
1.
用 taskId 调用 4.2.1.2，读取 status：
1 等待中 / 2 进行中：继续轮询；
3 成功：返回 downloadUrl，进入第三步；
4 失败：终止本轮对账并告警，重新调用 4.2.1.1 会创建新任务。
2.
建议轮询间隔：首次 5 秒，之后按 5s→15s→30s→60s 退避，单任务轮询不超过 30 分钟。
第三步：下载并解析对账文件
1.
使用 downloadUrl 直接 GET 下载 ZIP（签名地址，无需再带任何请求头）。
2.
解压得到 xlsx，按「四、对账单文件字段」解析。
3.
签名地址 10 分钟过期，过期后重新调用 4.2.1.2 获取新地址即可，无需重建任务。
4.2.1.3 用于查询历史任务与补偿：本地任务记录丢失、或需批量核对某段时间任务结果时使用。

时序图#

三、接口明细#

3.1 接口列表#

接口编号接口路径方法名说明
4.2.1.1POST /v1/open/dump/reconciliation/task/createcreateTask对账单下载任务创建
4.2.1.2POST /v1/open/dump/reconciliation/task/getgetTask对账单下载任务查询（获取下载地址）
4.2.1.3POST /v1/open/dump/reconciliation/task/pagepageTask对账单下载任务分页查询

3.2 4.2.1.1 对账单下载任务创建#

请求 reqBody：
字段类型必填说明
billDateString是账单日期，格式 yyyy-MM-dd；不晚于当天，最早回溯 90 天
merchantNoString否指定出账商户；不传时按应用商户类型对其全部下级出账
应答 rspBody：
字段类型说明
taskIdInteger任务编号，后续查询与下载均以此为准
billDateString账单日期
statusInteger任务状态，创建后为 1
statusDescString任务状态描述
fileNameString对账文件名（ZIP，内含同名 xlsx）
downloadUrlString下载地址，任务未完成时为空
expireTimeString文件保留截止时间，yyyy-MM-dd HH:mm:ss
createTimeString任务创建时间

3.3 4.2.1.2 对账单下载任务查询#

请求 reqBody：
字段类型必填说明
taskIdInteger是4.2.1.1 返回的任务编号
应答 rspBody： 字段同 4.2.1.1，其中：
status=3 且未过保留期 → 必带 downloadUrl（签名地址，10 分钟内有效）；
任务已过保留期 → 返回错误码 12202，需用同一 billDate 重新调用 4.2.1.1；
taskId 不属于当前应用 → 统一返回 12201 对账任务不存在。

3.4 4.2.1.3 对账单下载任务分页查询#

请求 reqBody：
字段类型必填说明
pageNumInteger否页码，默认 1
pageSizeInteger否每页条数，默认 10，最大 100
statusInteger否按任务状态过滤，不传返回全部状态
应答 rspBody：
字段类型说明
listArray任务列表，元素结构同 4.2.1.1，按任务编号倒序
totalLong总记录数
pageNumInteger当前页码
pageSizeInteger每页条数
列表中的任务为已过文件保留期时，该条 downloadUrl 返回空，不报错；需要下载地址请逐条调用 4.2.1.2。

四、对账单文件字段#

xlsx 首个 Sheet 顶部为账单条件区（商户号、账单起止时间等），明细列如下：
列说明
支付方式支付宝 / 微信 / 银联等
商户编号 / 商户名称交易归属商户
门店编号 / 门店名称交易归属门店
通道名称我方接入的支付通道
终端号终端设备编号
支付类型扫码 / 刷卡 / 刷脸等
创建时间订单创建时间
结算时间账单归属时间
商户订单号调用方订单号（outTradeNo）
订单金额下单金额，元
交易金额实际交易金额，元（退款行为退款金额）
结算金额结算入账金额，元
费率手续费费率，万分比整数
手续费交易手续费，元
订单状态支付成功 / 退款成功
商户退款单号退款行对应的商户退款单号
卡类型借记卡 / 贷记卡
通道订单号通道侧订单号
通道用户标识通道侧用户 ID
请求流水号我方支付流水号
订单标题商品/订单描述
对账建议：以 商户订单号 为主键与我方流水逐笔核对，退款行以 商户退款单号 核对；金额核对使用 交易金额 + 手续费 + 结算金额 三者勾稽。

五、错误码#

错误码说明处理建议
200成功-
12001缺少必填参数检查 billDate/taskId
12002参数格式错误billDate 必须为 yyyy-MM-dd
12003账单日期不能晚于当前日期改为已结算日期
12004账单日期超出可下载范围仅支持近 90 天，更早账单联系平台
12005应用未关联商户联系平台完成应用与商户绑定
12101商户不存在核对商户编号
12102商户类型不支持对账单下载联系平台核实应用商户类型
12103商户不属于当前应用只能对账本商户或其下挂商户
12201对账任务不存在核对 taskId，或确认任务由本应用创建
12202对账文件已超过保留期用同一 billDate 重新调用 4.2.1.1
12203对账文件下载地址生成失败稍后重试 4.2.1.2，持续失败联系平台
12999系统内部错误稍后重试

六、注意事项#

1.
不要并发提交同一账单：任务提交后请轮询等待，4.2.1.1 的幂等仅覆盖「同账单日期同一商户范围」的进行中/已成功任务。
2.
任务失败不自动重试：status=4 时重新调用 4.2.1.1 会创建新任务；请记录失败时的 billDate 便于排查。
3.
下载地址不要持久化或转发：地址为带签名的临时链接，仅 10 分钟有效，请勿写入日志或转交给商户侧长期保存。
4.
大账单耗时：明细按每批 5000 行流式写入，百万级订单的账单生成可能需要数分钟，请把轮询超时设置得足够长。
5.
平台侧调度窗口：导出任务在固定线程池内排队执行，高峰期排队时间会体现在 status=1 阶段。
6.
对账文件字段暂不支持定制：列顺序与内容与运营端「交易订单导出」一致，如需增删字段请联系平台评估。

附录：接口总览#

接口编号模块接口路径说明
4.2.1.1对账下载/v1/open/dump/reconciliation/task/create对账单下载任务创建
4.2.1.2对账下载/v1/open/dump/reconciliation/task/get对账单下载任务查询
4.2.1.3对账下载/v1/open/dump/reconciliation/task/page对账单下载任务分页查询

任务与提交接口对应关系#

提交接口查询接口回调通知说明
4.2.1.1（创建对账任务）4.2.1.2（task/get）不支持需轮询获取下载地址
-4.2.1.3（task/page）不支持历史任务补偿查询

核心枚举速查#

枚举说明关键值
ExcelExportTaskStatusEnum对账任务状态1=等待中, 2=进行中, 3=成功, 4=失败
PayStatusCodeEnum账单内订单状态1=支付成功, 5=退款成功（对账单仅含这两类）
SbmchMerchantTypeEnum应用关联商户类型1=普通商户, 2=代理商户, 3=品牌商户
修改于 2026-09-28 08:59:33
上一页
3.2 余额分账业务接入指引
下一页
4.1.1.1 公共文件上传（进件用上传临时文件）
Built with