平台收付通（二级商户进件）开发指引
更新时间：2024.09.06# 1. 接口规则
为了在保证支付安全的前提下，带给商户简单、一致且易用的开发体验，我们推出了全新的微信支付APIv3接口。该版本API的具体规则请参考APIv3接口规则。
# 2. 开发准备
# 2.1. 搭建和配置开发环境
为了帮助开发者调用开放接口，我们提供了JAVA、PHP、GO三种语言版本的开发库，封装了签名生成、签名验证、敏感信息加/解密、媒体文件上传 等基础功能（更多语言版本的开发库将在近期陆续提供）。
测试步骤：
1、根据自身开发语言，选择对应的开发库并构建项目，具体配置请参考下面链接的详细说明：
- wechatpay-java (opens new window)（推荐）、wechatpay-apache-httpclient (opens new window)，适用于Java开发者。
- 注：当前开发指引接口JAVA示例代码采用wechatpay-apache-httpclient版本。
- wechatpay-php (opens new window)（推荐）、wechatpay-guzzle-middleware (opens new window)，适用于PHP开发者。
- 注：当前开发指引接口PHP示例代码采用wechatpay-guzzle-middleware版本。
- wechatpay-go (opens new window)，适用于Go开发者。
更多资源可前往微信支付开发者社区 (opens new window)搜索查看。
2、创建加载商户私钥、加载平台证书、初始化httpClient的通用方法。
3、基于接口的示例代码，替换请求参数后可发起测试。
说明：
- 上面的开发库为微信支付官方开发库，其它没有审核或者控制下的第三方工具和库，微信支付不保证它们的安全性和可靠性。通过包管理工具引入SDK后，可根据下面每个接口的示例代码替换相关参数后进行快速测试。
- 开发者如果想详细了解签名生成、签名验证、敏感信息加/解密、媒体文件上传等常用方法的具体代码实现，可阅读下面的详细说明：
- 如想更详细的了解我们的接口规则，可查看我们的接口规则指引文档。
# 2.2. 业务开发配置-二级商户进件
- 平台需确认是否已开通平台工具箱，详细可前往平台收付通介绍 (opens new window)查看。
- 待进件的二级商户是否符合进件要求，相关要求可以前往二级商户入驻介绍查看。
# 3. 快速接入
# 3.1. 业务流程图-二级商户进件
重要步骤说明：
步骤1 平台通过请求二级商户进件接口帮助二级商户提交商户进件资料。进件参数中包含了敏感信息参数，此类参数要求进行加密，详见 接口规则。
步骤2 提交进件资料后，平台需通过微信支付返回的微信支付申请单号和业务申请编号来请求查询申请状态API接口查询二级商户进件状态。
步骤3 进件成功后，若二级商户需修改结算账号时，平台可通过请求修改商户结算账号API接口来帮助二级商户修改账号信息。
步骤4 平台通过请求查询商户结算账号API接口来查询修改情况。
# 3.2. API接入-二级商户进件
本文档展示了如何使用微信支付服务端 SDK 快速接入平台收付通产品，完成与微信支付对接的部分。
注意
- 文档中的代码示例是用来阐述 API 基本使用方法，代码中的示例参数需替换成商户自己账号及请求参数才能跑通。
- 以下接入步骤仅提供参考，请商户结合自身业务需求进行评估、修改。
# 3.2.1.【服务端】二级商户进件申请
步骤说明： 平台，可使用该接口，帮助其二级商户进件成为微信支付商户。
更多参数、响应详情及错误码请参见二级商户进件申请API接口文档。
# 3.2.2.【服务端】查询进件申请状态
步骤说明： 平台，可使用该接口，帮助其二级商户查询进件状态。
更多参数、响应详情及错误码请参见查询进件申请状态API接口文档。
# 3.2.3.【服务端】修改结算账号
步骤说明： 二级商户结算账号错误或者变更，平台可通过该接口进行修改。
更多参数、响应详情及错误码请参见修改结算账号API接口文档。
# 3.2.4.【服务端】查询结算账号
步骤说明： 平台可使用该接口，帮助其二级商户查询结算账号。
更多参数、响应详情及错误码请参见查询结算账号API接口文档。
