1. 3、业务指引
  • 1、接入指引
    • 1.1 阅读人员与名词解释
    • 1.2版本发布说明
    • 1.3接入准备
    • 1.4接入指引
  • 2、平台规范
    • 2.1接口格式定义
    • 2.2 加签验签说明与代码示例
    • 2.3 参数说明
    • 2.4上线前检查清单
  • 3、业务指引
    • 3.1 商户入网业务接入指引
  • 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.2聚合支付交易类接口
    • 4.3订单分账类接口
    • 4.4余额分账类接口
      • 4.4.1 余额分账相关接口
        • 4.4.1.1 B2B转账
        • 4.4.1.2 转账查询
      • 4.4.2 余额查询接口
        • 4.4.2.1 余额查询
      • 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.2 资产交易（核销）
      • 4.7.3 资产交易（核销）查询
      • 4.7.4 资产交易（核销）撤销
      • 4.7.5 资产交易（核销）退款
      • 4.7.6 资产交易（核销）退款查询
      • 4.7.7 资产余额查询
      • 4.7.8 资产交易对账单拉取
      • 4.7.9 付款码订单轮询查询
      • 4.7.10 付款码订单结果通知
    • 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 清分状态查询
    • 4.1.2 商户入网与配置
  • F.附录
  • FAQ
  • 数据模型
    • BalanceQueryResponse
    • ComplaintItem
    • EbkAccountRegisterResp
    • MerchantAddResp
    • PageDTO
    • MktAssetPreQueryVO
    • EbkAccountBalResp
    • EbkTransferCreateResp
    • OpenApiResponseBalanceQueryResponse
    • MerchantPictureUploadResp
    • ComplaintPageResp
    • OpenApiResponseMerchantAddResp
    • OpenApiResponseEbkAccountRegisterResp
    • MccTreeResp
    • OpenApiResponseListMccTreeResp
    • OpenApiResponseMerchantPictureUploadResp
    • OpenApiResponseMktAssetPreQueryVO
    • OpenApiResponseEbkAccountBalResp
    • OpenApiResponseEbkTransferCreateResp
    • OpenApiResponseMapObject
    • BalanceQueryRequest
    • GenericResponseMerchantPictureUploadResp
    • OpenApiResponseComplaintPageResp
    • GenericResponseMerchantAddResp
    • ApplyInfo
    • GenericResponseListMccTreeResp
    • EbkTransferQueryReq
    • MktAssetPreQueryDTO
    • EbkTransferCreateReq
    • OpenApiResponseString
    • OpenApiRequestBalanceQueryRequest
    • MerchantPictureUploadReq
    • ComplaintPageReq
    • BasicInfo
    • EbkAccountRegisterReq
    • MccTreeReq
    • OpenApiRequestMccTreeReq
    • OpenApiRequestEbkTransferQueryReq
    • OpenApiRequestMerchantPictureUploadReq
    • OpenApiRequestMktAssetPreQueryDTO
    • OpenApiRequestEbkTransferCreateReq
    • AccountTransferResponse
    • OpenApiRequestComplaintPageReq
    • OpenApiRequestEbkAccountRegisterReq
    • MerchantAddReq
    • AreaResp
    • JSONObject
    • MktAssetPayVO
    • EbkWithdrawCreateResp
    • OpenApiResponseString
    • OpenApiResponseAccountTransferResponse
    • ComplaintOrderInfo
    • OpenApiRequestMerchantAddReq
    • BankCard
    • GenericResponseListAreaResp
    • OpenApiResponseListAreaResp
    • OpenApiResponseMktAssetPayVO
    • OpenApiResponseEbkWithdrawCreateResp
    • PayRequest
    • AccountTransferRequest
    • ComplaintMediaList
    • MerchantUpdateResp
    • EbkAccountInfoResp
    • AreaListReq
    • MktAssetPayDTO
    • EbkWithdrawCreateReq
    • OpenApiRequestPayRequest
    • OpenApiRequestAccountTransferRequest
    • ServiceOrderInfo
    • OpenApiResponseMerchantUpdateResp
    • GenericResponseMerchantUpdateResp
    • OpenApiResponseEbkAccountInfoResp
    • BankParentResp
    • OpenApiRequestAreaListReq
    • OpenApiRequestMktAssetPayDTO
    • OpenApiRequestEbkWithdrawCreateReq
    • OpenApiRequestString
    • AccountTransferQueryResponse
    • ReturnAddressInfo
    • BasicInfo
    • EbkAccountQueryReq
    • GenericResponseListBankParentResp
    • MktAssetQueryPayVO
    • RefundRequest
    • OpenApiResponseAccountTransferQueryResponse
    • SharePowerInfo
    • OpenApiRequestEbkAccountQueryReq
    • MerchantUpdateReq
    • BankParentListReq
    • OpenApiResponseListBankParentResp
    • OpenApiResponseMktAssetQueryPayVO
    • ClearItem
    • OpenApiRequestRefundRequest
    • AccountTransferQueryRequest
    • AdditionalInfo
    • EbkWithdrawQueryReq
    • OpenApiRequestMerchantUpdateReq
    • BankResp
    • MktAssetQueryPayDTO
    • EbkClearCreateReq
    • OpenApiRequestAccountTransferQueryRequest
    • WxComplaintDetail
    • OpenApiRequestEbkWithdrawQueryReq
    • ChannelInfo
    • GenericResponseListBankResp
    • EbkBankCardBindReq
    • OpenApiRequestBankParentListReq
    • OpenApiRequestMktAssetQueryPayDTO
    • OpenApiRequestEbkClearCreateReq
    • AccountWithdrawResponse
    • EbkClearQueryResp
    • MapString
    • MemberAddResp
    • BankListReq
    • OpenApiRequestEbkBankCardBindReq
    • MktAssetCancelVO
    • OpenApiResponseAccountWithdrawResponse
    • ComplaintTradeInfo
    • OpenApiResponseEbkClearQueryResp
    • OpenApiResponseMemberAddResp
    • GenericResponseMemberAddResp
    • MccYbTreeReq
    • EbkBankCardUnbindReq
    • OpenApiResponseListBankResp
    • OpenApiResponseMktAssetCancelVO
    • AccountWithdrawRequest
    • AlipaySecurityRiskComplaintInfoQueryResponse
    • EbkClearQueryReq
    • MerchantBasicInfo
    • MccEasypayTreeReq
    • OpenApiRequestEbkBankCardUnbindReq
    • MktAssetCancelDTO
    • OpenApiRequestAccountWithdrawRequest
    • ComplaintDetailResp
    • OpenApiRequestEbkClearQueryReq
    • LicenseInfo
    • MccMappingEasypayResp
    • OpenApiRequestBankListReq
    • OpenApiRequestMktAssetCancelDTO
    • AccountWithdrawQueryResponse
    • OpenApiResponseComplaintDetailResp
    • LegalInfo
    • GenericResponseListMccMappingEasypayResp
    • MktAssetRefundVO
    • OpenApiResponseAccountWithdrawQueryResponse
    • ComplaintDetailReq
    • SettlementInfo
    • OpenApiRequestMccYbTreeReq
    • OpenApiResponseMktAssetRefundVO
    • AccountWithdrawQueryRequest
    • OpenApiRequestComplaintDetailReq
    • ChannelInfo
    • MccMappingPaResp
    • MktAssetRefundDTO
    • OpenApiRequestAccountWithdrawQueryRequest
    • PictureInfo
    • OpenApiResponseVoid
    • OpenApiRequestMccEasypayTreeReq
    • GenericResponseListMccMappingPaResp
    • OpenApiRequestMktAssetRefundDTO
    • UploadItem
    • MemberAddReq
    • MccMappingPaReq
    • MktAssetQueryRefundVO
    • MapObject
    • ComplaintReplyReq
    • OpenApiRequestMemberAddReq
    • OpenApiResponseListMccMappingEasypayResp
    • OpenApiResponseMktAssetQueryRefundVO
    • BankCardAccount
    • OpenApiRequestComplaintReplyReq
    • ChannelInfo
    • MccMappingEasypayReq
    • MktAssetQueryRefundDTO
    • ComplaintCompleteReq
    • MemberUpdateResp
    • GenericResponseMemberUpdateResp
    • OpenApiRequestMccMappingEasypayReq
    • OpenApiRequestMktAssetQueryRefundDTO
    • BindCardQueryRespDTO
    • OpenApiRequestComplaintCompleteReq
    • OpenApiResponseMemberUpdateResp
    • MktAssetBalanceVO
    • OpenApiResponseBindCardQueryRespDTO
    • ComplaintImageUploadResp
    • MerchantBasicInfo
    • LicenseInfo
    • OpenApiResponseListMccMappingPaResp
    • OpenApiResponseMktAssetBalanceVO
    • WithdrawCardQueryRequest
    • OpenApiResponseComplaintImageUploadResp
    • MktAssetBalanceDTO
    • OpenApiRequestWithdrawCardQueryRequest
    • ComplaintImageUploadReq
    • LegalInfo
    • OpenApiRequestMccMappingPaReq
    • OpenApiRequestMktAssetBalanceDTO
    • OpenApiRequestComplaintImageUploadReq
    • SettlementInfo
    • MktAssetReconciliationRecord
    • ComplaintImageViewResp
    • PictureInfo
    • MktAssetReconciliationVO
    • OpenApiResponseComplaintImageViewResp
    • MemberUpdateReq
    • OpenApiResponseMktAssetReconciliationVO
    • ComplaintImageViewReq
    • OpenApiRequestMemberUpdateReq
    • MktAssetReconciliationDTO
    • OpenApiRequestComplaintImageViewReq
    • ChannelInfo
    • OpenApiRequestMktAssetReconciliationDTO
    • ChannelAddResp
    • GenericResponseChannelAddResp
    • MktAssetQueryPayCodeOrderVO
    • OpenApiResponseChannelAddResp
    • OpenApiResponseMktAssetQueryPayCodeOrderVO
    • ChannelAddReq
    • MktAssetQueryPayCodeOrderDTO
    • OpenApiRequestChannelAddReq
    • OpenApiRequestMktAssetQueryPayCodeOrderDTO
    • ChannelInfo
    • GenericResponseChannelUpdateResp
    • MktAssetNotifyPayResultVO
    • ChannelUpdateResp
    • OpenApiResponseMktAssetNotifyPayResultVO
    • OpenApiResponseChannelUpdateResp
    • ApplyInfo
    • MktAssetNotifyPayResultDTO
    • OpenApiRequestMktAssetNotifyPayResultDTO
    • OpenApiRequestChannelUpdateReq
    • ChannelUpdateReq
    • LicenseInfo
    • ApplyInfo
    • LegalInfo
    • MerchantBasicInfo
    • SettlementInfo
    • ChannelInfo
    • PictureInfo
    • ChannelInfo
    • GenericResponseMerchantDetailResp
    • MerchantDetailResp
    • OpenApiResponseMerchantDetailResp
    • GenericResponseSplitOpenResp
    • MerchantDetailReq
    • key
    • OpenApiRequestMerchantDetailReq
    • SplitOpenResp
    • OpenApiResponseSplitOpenResp
    • GenericResponseSplitUpdateResp
    • SplitParam
    • SplitOpenReq
    • OpenApiRequestSplitOpenReq
    • key
    • SplitUpdateResp
    • OpenApiResponseSplitUpdateResp
    • SplitQueryResp
    • GenericResponseListSplitQueryResp
    • SplitParam
    • SplitUpdateReq
    • SplitQueryReq
    • OpenApiRequestSplitUpdateReq
    • SplitConfigInfo
    • GenericResponseSplitBindResp
    • SplitBindReq
    • OpenApiResponseListSplitQueryResp
    • GenericResponseSplitUnbindResp
    • OpenApiRequestSplitQueryReq
    • SplitUnbindReq
    • SplitBindResp
    • WechatConfigItem
    • OpenApiResponseSplitBindResp
    • WechatConfigSaveResp
    • GenericResponseWechatConfigSaveResp
    • OpenApiRequestSplitBindReq
    • SplitUnbindResp
    • WechatConfigSaveReq
    • OpenApiResponseSplitUnbindResp
    • WechatConfigItem
    • OpenApiRequestSplitUnbindReq
    • GenericResponseWechatConfigQueryResp
    • WechatConfigQueryReq
    • OpenApiResponseWechatConfigSaveResp
    • GenericResponseRealnameAuthApplyResp
    • AppidConfigItem
    • RealnameAuthApplyReq
    • OpenApiRequestWechatConfigSaveReq
    • GenericResponseRealnameAuthStatusResp
    • RealnameAuthStatusQueryReq
    • WechatConfigQueryResp
    • OpenApiResponseWechatConfigQueryResp
    • GenericResponseRealnameAuthResultResp
    • RealnameAuthResultQueryReq
    • OpenApiRequestWechatConfigQueryReq
    • RealnameAuthApplyResp
    • OpenApiResponseRealnameAuthApplyResp
    • OpenApiRequestRealnameAuthApplyReq
    • RealnameAuthStatusResp
    • OpenApiResponseRealnameAuthStatusResp
    • OpenApiRequestRealnameAuthStatusQueryReq
    • RealnameAuthResultResp
    • OpenApiResponseRealnameAuthResultResp
    • OpenApiRequestRealnameAuthResultQueryReq
  1. 3、业务指引

3.1 商户入网业务接入指引

本文档为开放平台对外接入指引，作为聚合支付方，对接各三方支付通道的进件能力。
接口路径前缀：商户接口 /v1/paycfg/merchant、上传接口 /v1/upload/paycfg、配置接口 /v1/common/config。
入网及通道类接口为 异步 处理：提交后通过查询接口获取处理结果。

一、公共配置接口（辅助接口）#

入网前需先获取基础配置数据（MCC类目、区域、银行等），不同通道有独立的 MCC 体系。
接口编号接口路径方法名说明
4.8.2.1POST /v1/common/config/mcc/treegetMccTree获取MCC行业类目树
4.8.2.2POST /v1/common/config/area/listgetAreaList获取区域列表（三级联动）
4.8.2.3POST /v1/common/config/bankParent/listgetBankParentList获取银行总行列表
4.8.2.4POST /v1/common/config/bank/listgetBankList获取银行支行列表
4.8.2.5POST /v1/common/config/mccYb/treegetMccYbTree获取易宝MCC行业类目树
4.8.2.6POST /v1/common/config/mccEasypay/treegetMccEasypayTree获取易生MCC行业类目树
4.8.2.7POST /v1/common/config/mccMappingEasypay/listgetMccMappingEasypayList获取易生MCC映射
4.8.2.8POST /v1/common/config/mccMappingPa/listgetMccMappingPaList获取平安银行MCC映射

二、文件上传说明#

2.1 流程说明#

1.
调用方准备商户进件所需的图片资料（身份证正反面、营业执照、门头照、结算账户信息等）。
2.
调用公共文件上传接口（接口编号 4.1.1.1），将图片上传至平台。
3.
接口返回图片的访问 URL（pictureUrl）。
4.
调用方保存 URL，在后续入网接口中直接引用该 URL。
5.
上传的图片为进件公共图片，一次上传可多次复用于不同接口的不同字段。
6.
返回的图片链接为临时文件，请尽快完成商户入网。

2.2 接口列表#

接口编号接口路径方法名说明
4.1.1.1POST /v1/upload/paycfg/merchantPicturemerchantPictureUpload公共文件上传（进件用）

2.3 时序图#

三、小微商户入网流程#

3.1 流程说明#

小微商户入网采用 三步走 模式：
第一步：商户添加（4.1.2.1）
1.
调用商户添加接口（接口编号 4.1.2.1），录入商户简单信息（商户名称等基础信息）。
2.
此步骤仅在平台侧创建商户记录，不涉及三方通道，返回 merchantNo（商户编号）。
第二步：信息补全并指定通道入网（4.1.2.3）
1.
调用收单商户入网接口（接口编号 4.1.2.3），补全商户完整信息并指定一个通道发起入网：
个人信息（姓名、身份证、结算银行卡等）
通道信息（通道类型、费率、MCC类目等）
2.
小微商户无需营业执照，只需个人身份信息。
3.
系统异步向三方通道发起进件。
4.
通过商户详情查询接口（接口编号 4.1.2.7）查询入网结果。
第三步：追加通道（4.1.2.5，可选）
1.
如需开通更多通道，调用通道添加接口（接口编号 4.1.2.5）独立指定某个通道入网。
2.
通过商户详情查询接口（接口编号 4.1.2.7）查询通道入网结果。
注意：小微商户不支持线上经营

3.2 接口列表#

接口编号接口路径方法名说明
4.1.2.1POST /v1/paycfg/merchant/addadd商户添加（简单信息录入）
4.1.2.3POST /v1/paycfg/merchant/member/addmemberAdd信息补全并指定通道入网
4.1.2.5POST /v1/paycfg/merchant/channel/addchannelAdd独立指定通道入网（可选）
4.1.2.7POST /v1/paycfg/merchant/detaildetail查询入网结果

3.3 时序图#

四、企业、工商户入网流程#

4.1 流程说明#

企业/工商户入网比小微商户多企业资质，采用 四步走 模式：
第一步：商户添加（4.1.2.1）
1.
调用商户添加接口（接口编号 4.1.2.1），录入商户简单信息。
2.
此步骤仅在平台侧创建商户记录，不涉及三方通道，返回 merchantNo。
第二步：文件上传 + 获取配置
1.
调用文件上传接口（接口编号 4.1.1.1），上传营业执照、法人身份证、开户许可证等企业资质文件。
2.
调用公共配置接口（接口编号 4.8.2.1~4.8.2.8）获取 MCC 类目、区域、银行等数据。
第三步：信息补全并指定通道入网（4.1.2.3）
1.
调用收单商户入网接口（接口编号 4.1.2.3），补全企业完整信息并指定一个通道发起入网：
企业资质（营业执照号、照片、经营范围等）
法人信息（姓名、身份证正反面、手机号）
结算信息（对公/法人账户、开户行、联行号）
经营信息（MCC类目、门店地址、门头照等）
通道信息（通道类型、费率等）
2.
系统异步向三方通道发起进件。
3.
通过商户详情查询接口（接口编号 4.1.2.7）查询入网结果。
第四步：追加通道（4.1.2.5，可选）
1.
入网成功后，如需开通更多通道，调用通道添加接口（接口编号 4.1.2.5）独立指定通道入网。
2.
企业商户可开通全部通道类型。
3.
通过商户详情查询接口（接口编号 4.1.2.7）查询通道入网结果。
关键区别：企业/工商户需提供营业执照、开户许可证、非法人结算授权函等企业资质文件；部分通道和流程需额外签约确认。

4.2 接口列表#

接口编号接口路径方法名说明
4.1.1.1POST /v1/upload/paycfg/merchantPicturemerchantPictureUpload公共文件上传
4.1.2.1POST /v1/paycfg/merchant/addadd商户添加（简单信息录入）
4.1.2.3POST /v1/paycfg/merchant/member/addmemberAdd信息补全并指定通道入网
4.1.2.5POST /v1/paycfg/merchant/channel/addchannelAdd独立指定通道入网（可选）
4.1.2.7POST /v1/paycfg/merchant/detaildetail查询入网结果
4.8.2.1~8公共配置接口各方法获取MCC/区域/银行等

4.3 时序图#

五、通道添加流程#

5.1 流程说明#

通道添加用于已创建商户 独立指定某个通道入网，不修改商户信息（前提是已经通过 4.1.2.3 或 4.1.2.4 完成商户信息的补录）：
1.
准备阶段：调用公共配置接口（4.8.2.1~4.8.2.8）获取目标通道的 MCC 类目树。
2.
提交通道添加：调用通道添加接口（接口编号 4.1.2.5），传入：
channelType：通道类型
rateMap：费率信息（支付宝/微信/银联费率等）
mccId：MCC 类目 ID
其他通道特有参数
3.
系统异步向三方通道发起进件。
4.
结果查询：通过商户详情查询接口（接口编号 4.1.2.7）查询通道入网结果。通道状态流转：
初始化(0) → 初审中(2) → 进件成功(1) / 审核失败(6)

5.2 接口列表#

接口编号接口路径方法名说明
4.8.2.1~8公共配置接口各方法获取MCC/区域/银行等
4.1.2.5POST /v1/paycfg/merchant/channel/addchannelAdd独立指定通道入网
4.1.2.7POST /v1/paycfg/merchant/detaildetail查询入网结果

5.3 时序图#

六、商户信息变更流程#

6.1 流程说明#

商户信息变更分为两种场景，使用不同的接口和查询方式：
场景一：不存在进件成功的通道时（4.1.2.3）
1.
调用收单商户入网接口（接口编号 4.1.2.3），更新商户信息和通道信息。
2.
此场景下商户尚未有三方通道进件成功，可自由修改全部信息。
3.
通过商户详情查询接口（接口编号 4.1.2.7）查询更新结果。
场景二：存在进件成功的通道时（4.1.2.4）
1.
调用收单商户更新接口（接口编号 4.1.2.4），全量更新商户信息并自动发起三方更新或入网。
2.
系统异步向三方通道同步变更信息或提交入网。
3.
通过商户更新详情查询接口（接口编号 4.1.2.8）查询更新结果。
注意：查询入网成功后的更新结果统一使用 4.1.2.8 接口，而非 4.1.2.7。

6.2 接口列表#

接口编号接口路径方法名说明
4.1.2.4POST /v1/paycfg/merchant/member/updatememberUpdate更新商户信息和通道信息
4.1.2.8POST /v1/paycfg/merchant/detail4Updatedetail4Update查询更新结果
4.1.1.1POST /v1/upload/paycfg/merchantPicturemerchantPictureUpload文件上传（如需更新资质图片）

6.3 时序图#

七、费率变更流程#

7.1 流程说明#

费率变更用于独立更新某个已入网通道的费率， 商户信息变更流程的场景一支持入网成功前的通道费率变更：
1.
查询当前费率：通过商户详情查询接口（接口编号 4.1.2.7）查询当前通道费率信息。
2.
提交费率变更：调用通道更新接口（接口编号 4.1.2.6），传入新的费率信息：
aliPayRate：支付宝费率
wechatPayRate：微信费率
unionPayRate：银联费率
3.
系统异步向三方通道提交费率变更。
4.
结果查询：通过商户更新详情查询接口（接口编号 4.1.2.8）查询费率变更结果。
注意：费率变更属于入网后的更新操作，结果通过 4.1.2.8 接口查询，而非 4.1.2.7。部分通道的费率变更不是实时生效的。

7.2 接口列表#

接口编号接口路径方法名说明
4.1.2.6POST /v1/paycfg/merchant/channel/updatechannelUpdate独立更新通道费率
4.1.2.7POST /v1/paycfg/merchant/detaildetail查询当前费率信息
4.1.2.8POST /v1/paycfg/merchant/detail4Updatedetail4Update查询费率变更结果

7.3 时序图#

八、微信关注配置流程#

8.1 流程说明#

商户入网开通微信公众号或小程序后（默认报备已完成），需调用此接口进行支付授权目录、支付appid的配置，配置后即可进行交易：
1.
查询当前配置：调用微信关注配置查询接口（接口编号 4.1.2.15），查询已有配置。
2.
保存配置：调用微信关注配置保存接口（接口编号 4.1.2.14），传入配置信息：
configType：配置类型
appidConfigList：AppID 关注配置列表
jsapiPathList：JSAPI 路径配置列表
channelId：通道 ID
3.
系统自动将配置同步至微信平台。
4.
通过查询接口确认配置结果。

8.2 接口列表#

接口编号接口路径方法名说明
4.1.2.14POST /v1/paycfg/merchant/wechatConfig/savewechatConfigSave微信关注配置保存
4.1.2.15POST /v1/paycfg/merchant/wechatConfig/querywechatConfigQuery微信关注配置查询

8.3 时序图#

九、实名认证流程#

9.1 流程说明#

实名认证用于对商户进行支付宝或微信的身份验证：
1.
发起实名认证：调用实名认证申请接口（接口编号 4.1.2.16），传入：
payMode：认证类型（300=支付宝、400=微信）
channelId：通道 ID
认证所需的企业/个人信息，从商户入网中的信息获取
2.
获取认证链接：系统根据通道类型调用对应的三方认证接口，返回认证链接/二维码 URL。
3.
用户完成认证：商户法人或负责人通过认证链接完成人脸识别等实名认证操作。
4.
状态查询：调用实名认证状态查询接口（接口编号 4.1.2.17），查询认证进度：
未申请(0) → 审核中(1) → 待确认(3) → 已授权(4) / 已驳回(2)
5.
结果查询：调用实名认证授权结果查询接口（接口编号 4.1.2.18），获取认证授权结果。

9.2 接口列表#

接口编号接口路径方法名说明
4.1.2.16POST /v1/paycfg/merchant/realnameAuth/applyrealnameAuthApply实名认证申请
4.1.2.17POST /v1/paycfg/merchant/realnameAuth/statusrealnameAuthStatus实名认证状态查询
4.1.2.18POST /v1/paycfg/merchant/realnameAuth/resultrealnameAuthResult实名认证授权结果查询

9.3 时序图#

十、分账开通与绑定流程#

10.1 流程说明#

分账功能分为 分账开通、分账关系绑定/解绑 两个子流程：

10.1.1 分账开通#

1.
调用分账开通接口（接口编号 4.1.2.9），传入：
merchantNo：商户编号
channelId：通道 ID
splitMode：分账模式（1=订单分账、2=余额分账）
分账比例、接收方信息等
2.
分账模式说明：
订单分账（模式1）：交易时按比例分账，支持易宝、易生支付通道
余额分账（模式2）：从余额中分账，仅支持易宝通道
3.
调用分账结果查询接口（接口编号 4.1.2.11）查询开通结果。
4.
如需变更分账配置，调用分账变更接口（接口编号 4.1.2.10）。

10.1.2 分账关系绑定/解绑#

1.
绑定：调用分账关系绑定接口（接口编号 4.1.2.12），建立分账关系：
传入分账发起方和接收方的商户编号
绑定状态流转：审核中(0) → 已绑定(1) / 驳回(2)
2.
解绑：调用分账关系解绑接口（接口编号 4.1.2.13），解除分账关系。
3.
通过分账结果查询接口（接口编号 4.1.2.11）查询绑定状态。

10.2 接口列表#

接口编号接口路径方法名说明
4.1.2.9POST /v1/paycfg/merchant/split/opensplitOpen分账开通
4.1.2.10POST /v1/paycfg/merchant/split/updatesplitUpdate分账变更
4.1.2.11POST /v1/paycfg/merchant/split/querysplitQuery分账结果查询
4.1.2.12POST /v1/paycfg/merchant/split/bindsplitBind分账关系绑定
4.1.2.13POST /v1/paycfg/merchant/split/unbindsplitUnbind分账关系解绑

10.3 时序图#

附录：接口总览#

Open API 全量接口编号索引#

接口编号模块接口路径说明
4.1.1.1文件上传/v1/upload/paycfg/merchantPicture公共文件上传
4.1.2.1商户/v1/paycfg/merchant/add商户添加（简单信息录入）
4.1.2.2商户/v1/paycfg/merchant/update商户更新（简单信息更新）
4.1.2.3商户/v1/paycfg/merchant/member/add信息补全并指定通道入网
4.1.2.4商户/v1/paycfg/merchant/member/update更新商户信息和通道信息
4.1.2.5商户/v1/paycfg/merchant/channel/add独立指定通道入网
4.1.2.6商户/v1/paycfg/merchant/channel/update独立更新通道费率
4.1.2.7商户/v1/paycfg/merchant/detail查询入网结果（4.1.2.3/4.1.2.5）
4.1.2.8商户/v1/paycfg/merchant/detail4Update查询更新结果（4.1.2.4/4.1.2.6）
4.1.2.9分账/v1/paycfg/merchant/split/open分账开通
4.1.2.10分账/v1/paycfg/merchant/split/update分账变更
4.1.2.11分账/v1/paycfg/merchant/split/query分账结果查询
4.1.2.12分账/v1/paycfg/merchant/split/bind分账关系绑定
4.1.2.13分账/v1/paycfg/merchant/split/unbind分账关系解绑
4.1.2.14微信/v1/paycfg/merchant/wechatConfig/save微信关注配置保存
4.1.2.15微信/v1/paycfg/merchant/wechatConfig/query微信关注配置查询
4.1.2.16实名/v1/paycfg/merchant/realnameAuth/apply实名认证申请
4.1.2.17实名/v1/paycfg/merchant/realnameAuth/status实名认证状态查询
4.1.2.18实名/v1/paycfg/merchant/realnameAuth/result实名认证结果查询
4.8.2.1配置/v1/common/config/mcc/treeMCC行业类目树
4.8.2.2配置/v1/common/config/area/list区域列表
4.8.2.3配置/v1/common/config/bankParent/list银行总行列表
4.8.2.4配置/v1/common/config/bank/list银行支行列表
4.8.2.5配置/v1/common/config/mccYb/tree易宝MCC树
4.8.2.6配置/v1/common/config/mccEasypay/tree易生MCC树
4.8.2.7配置/v1/common/config/mccMappingEasypay/list易生MCC映射
4.8.2.8配置/v1/common/config/mccMappingPa/list平安MCC映射

查询接口对应关系#

提交接口查询接口说明
4.1.2.3（信息补全+指定通道入网）4.1.2.7（detail）查询入网结果
4.1.2.5（独立指定通道入网）4.1.2.7（detail）查询入网结果
4.1.2.4（更新商户信息和通道信息）4.1.2.8（detail4Update）查询更新结果
4.1.2.6（独立更新通道费率）4.1.2.8（detail4Update）查询更新结果

核心枚举速查#

枚举说明关键值
PaySplitModeEnum分账模式1=订单分账(全通道), 2=余额分账(部分通道)
PaySplitBindStatusEnum分账绑定状态0=审核中, 1=已绑定, 2=驳回, 3=已解绑
ChannelGrantStatusEnum实名认证状态0=未申请, 1=审核中, 2=已驳回, 3=待确认, 4=已授权
修改于 2026-08-12 08:46:02
上一页
2.4上线前检查清单
下一页
4.1.1.1 公共文件上传（进件用上传临时文件）
Built with