1. 4.1.2 商户入网与配置
  • 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 商户添加
          POST
        • 4.1.2.2 商户更新
          POST
        • 4.1.2.3 收单商户入网
          POST
        • 4.1.2.4 收单商户更新
          POST
        • 4.1.2.5 通道添加
          POST
        • 4.1.2.6 通道变更
          POST
        • 4.1.2.7 商户详情查询
          POST
        • 4.1.2.8 收单商户更新详情查询
          POST
        • 4.1.2.9 分账开通
          POST
        • 4.1.2.10 分账变更
          POST
        • 4.1.2.11 分账开通结果查询
          POST
        • 4.1.2.12 分账关系绑定
          POST
        • 4.1.2.13 分账关系解绑
          POST
        • 4.1.2.14 微信关注配置
          POST
        • 4.1.2.15 微信关注配置查询
          POST
        • 4.1.2.16 实名认证申请
          POST
        • 4.1.2.17 实名认证申请状态查询
          POST
        • 4.1.2.18 实名认证授权状态结果查询
          POST
        • 4.1.2.19 商户入网通知
          POST
      • 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. 4.1.2 商户入网与配置

4.1.2.5 通道添加

测试环境
https://openapi-dev.51shoubei.com/openApi
测试环境
https://openapi-dev.51shoubei.com/openApi
POST
https://openapi-dev.51shoubei.com/openApi
/v1/paycfg/merchant/channel/add
通过本接口为商户添加新的支付通道，仅包含通道相关参数（行业类目、费率配置）。
注意：
该接口仅支持还未入网成功的通道添加，入网成功的通道更新费率调用4.1.2.6；
该接口的调用前提是已经通过4.1.2.3或4.1.2.4接口补全了商户信息；

请求参数

Header 参数

Body 参数application/json

示例
{
    "requestId": "string",
    "timestamp": "string",
    "nonce": "stringstringstri",
    "sign": "string",
    "reqBody": {
        "merchantNo": "string",
        "channelId": 0,
        "mccId": 0,
        "settlementDirection": "string",
        "aliPayRate": 0,
        "wechatPayRate": 0,
        "unionPayRate": 0,
        "aliWxMccId": 0,
        "longitude": "string",
        "latitude": "string",
        "notifyUrl": "string"
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://openapi-dev.51shoubei.com/openApi/v1/paycfg/merchant/channel/add' \
--header 'api-key: AK-14ad9367db5e4a62be1f8506ed5291b0' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "string",
    "timestamp": "string",
    "nonce": "stringstringstri",
    "sign": "string",
    "reqBody": {
        "merchantNo": "string",
        "channelId": 0,
        "mccId": 0,
        "settlementDirection": "string",
        "aliPayRate": 0,
        "wechatPayRate": 0,
        "unionPayRate": 0,
        "aliWxMccId": 0,
        "longitude": "string",
        "latitude": "string",
        "notifyUrl": "string"
    }
}'

返回响应

🟢200
application/json
Bodyapplication/json

示例
{
  "code": 0,
  "msg": "",
  "timestamp": "",
  "sign": "",
  "nonce": "",
  "rspBody": {
    "merchantNo": "",
    "channelInfo": {
      "channelId": 0,
      "channelName": "",
      "aliPayRate": 0,
      "wechatPayRate": 0,
      "unionPayRate": 0,
      "status": 0,
      "failMsg": "",
      "channelMchNo": "",
      "agreementSignUrl": ""
    }
  }
}
修改于 2026-09-23 03:34:17
上一页
4.1.2.4 收单商户更新
下一页
4.1.2.6 通道变更
Built with