1. 1、接入指引
  • 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. 1、接入指引

1.3接入准备

快速接入#

本文档将系统性指导您完成收呗开放平台的接入流程，帮助您高效开始使用平台提供的各项金融科技能力。通过遵循本指南的步骤，您可以规范、有序地完成从应用创建到正式上线的全过程，快速实现业务价值。
流程概览

一、商户入网并签约产品#

1. 查看产品开通情况#

2. 检查应用配置#

查看应用信息： 确认应用标识（AppKey）和应用名称，这是您应用的唯一身份标识
确认应用权限范围：验证应用是否具备所需产品的访问权限，确保权限配置完整

二、密钥配置#

1. 密钥制备#

2. 密钥配置#

三、开发对接#

1. API 对接准备#

了解业务场景和模型：明确您的业务需求与平台能力的匹配点，设计合理的业务流程；也可联系收呗商务经理以及客服，让收呗技术团队协助您匹配技术方案
确定需要使用的具体接口：根据业务流程选择合适的接口组合，避免冗余调用
查看详细的 API 文档：深入了解接口的请求参数、响应结果和业务规则，确保正确实现
了解签名算法和参数规范：掌握安全验证机制，确保请求能够通过平台的安全验证

2. 关键开发要点#

严格按照接口文档规范传递参数：注意必填项、参数格式和长度限制，避免因参数错误导致调用失败
正确处理接口返回结果：根据返回码判断交易状态，合理处理成功和异常情况
实现异步通知接收接口：开发稳定可靠的回调接口，确保能够接收并处理平台的异步通知
注意接口调用频率限制：遵循平台的调用频率规范，实现合理的请求控制，避免触发限流措施
通信安全：请严格遵循平台的接口通信加密验签安全机制，确保可信的通信安全，放置通信劫持与伪造

3. 异步通知处理#

实现通知接收接口：开发专门的服务端接口接收平台异步通知，确保高可用性
验证通知签名：使用平台公钥验证通知的真实性，防止伪造请求
处理业务逻辑：根据通知内容更新本地订单状态，确保数据一致性
返回正确的响应格式：接收成功后返回"success"字符串，避免平台重复发送通知
重要提示：务必同时实现主动查单接口，在异步通知失败时主动查询订单状态，确保数据一致性。建议设置定时任务，对未收到通知的订单进行状态查询，构建完善的订单状态管理机制。

四、测试验证#

1. 沙箱环境测试#

使用平台提供的沙箱环境进行全面功能测试，避免影响生产数据
验证各个接口的调用是否正常，参数传递是否正确
测试各种异常场景的处理逻辑，确保系统稳定性
检查异步通知接收和处理是否符合预期
测试要点：
正常交易流程测试
异常情况处理测试
并发请求测试
数据一致性验证

2. 联调测试#

与收呗技术支持团队进行专业联调测试，获取技术支持
解决测试过程中发现的各类问题，优化系统实现
确认所有功能符合预期，满足业务需求
完成上线前的最终验收测试

五、安全建议#

1. 密钥管理#

妥善保管私钥：将私钥存储在安全的位置，严格控制访问权限，避免泄露
定期更新密钥：建议每3-6个月更新一次密钥，降低安全风险
使用安全的密钥存储方式：考虑使用硬件加密模块或专业密钥管理系统，提升安全等级

2. 通信安全#

使用 HTTPS 协议：确保传输层安全，防止数据被窃听或篡改
验证请求签名：验证所有来自平台的请求签名，确保请求真实性
加密敏感数据：对敏感信息进行加密处理，保护用户隐私和账户安全

3. 业务安全#

实现幂等性控制：为所有交易请求设计唯一标识，防止重复请求导致的数据异常
做好日志记录：记录详细的操作日志和交易日志，便于问题排查和安全审计
增加必要的业务校验：实施金额限制、交易频率控制、异常交易监控等安全措施
修改于 2026-07-30 01:24:48
上一页
1.2版本发布说明
下一页
2.1接口格式定义
Built with