平台收付通（二级商户进件）开发指引
更新时间：2023.08.22# 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接口文档。
# 4. 常见问题
# Q:平台收付通进件调用“二级商户进件接口”返回：贵司涉及保险业务并提供《经营保险业务许可证》/《保险业务法人等级证书》等，其他公司提供相关资质
A：返回这个报错，请求参数中请上传特殊资质（qualifications）字段。
# Q:平台收付通进件调用“查询进件申请状态接口”没有返回“法人验证链接legal_validation_url”
A：主体类型为党政、机关及事业单位 /其他组织时，只能汇款验证，是不会返回法人验证链接的。接入流程说明文档中的第4点也有说明。
# Q:平台收付通进件“查询申请状态接口”：开户状态为“已冻结”是在什么情况下出现？ 开户成功之后会出现冻结情况吗
A：申请状态已冻结是审核人员认为有风险时候，会冻结。开户成功后，基本不会出现已冻结。
# Q:平台收付通进件调用“二级商户进件接口”返回：商户简称取值有误，你输入的商户简称涉及敏感字段，不符合相关规定，请检查后重新输入
A：参数merchant_shortname命中敏感字段，请更换一个新的简称重新提交。
# Q:平台收付通进件调用“二级商户进件接口”返回：身份证结束日期有误，结束日期必须晚于当前60天
A：参数id_card_valid_time错误，请严格按照文档要求传参，这个参数的规则如下：
- 请填写身份证有效期的结束时间，注意参照示例中的格式。
- 若证件有效期为长期，请填写：长期。
- 证件有效期需大于60天。
