有道无术,术尚可求,有术无道,止于术。
文章目录
- 项目概述
- 接入准备
- 1. 注册服务商号(获取服务商mchid)
- 2. 注册公众号(获取服务商APPID)
- 3. 绑定应用ID和服务商ID
- 4. 入驻子商户(特约商户进件)
- 5. 配置API v3密钥(服务商)
- 6. 下载并配置商户证书
- 汇总
项目概述
下面以一个简单的项目为背景,讲解怎么接入微信服务商
。
本公司需要开发一套支付系统,为第三方网站、APP等应用提供多种支付功能。
系统简要功能:
- 商户管理:新增商户、商户进件
- 支付:统一下单
- 订单管理:支付、退款单查询
- 分账管理
接入准备
开发一套支付系统,首先和商户接入微信支付一样,接入前需要很多准备工作。
1. 注册服务商号(获取服务商mchid)
官方注册服务商号操作详细教程
注册完成后扫码登录,首页如图所示:
服务商的收款账号即是mchid
,申请成功后,微信支付将下发通知邮件至机构填写的联系邮箱,内容包含申请成功的mchid
及其登录账号密码,请妥善保存。
注意:一个mchid
只能对应一个结算币种,若需要使用多个币种收款,需要申请对应数量的mchid
。
2. 注册公众号(获取服务商APPID)
由于微信支付的产品体系全部搭载于微信的社交体系之上,所以直连商户或服务商接入微信支付之前,都需要有一个微信社交载体。
目前服务商的社交载体只能是公众号,服务商可通过公众平台完成公众号注册申请。通常情况下,一个服务商只需申请一个公众号即可。
公众号申请成功后,服务商可登录公众平台即可获取对应的APPID
,具体查阅目录为 【开发-> 基本配置-> 公众号开发信息】,如下图所示。
3. 绑定应用ID和服务商ID
APPID
和mchid
全部申请完毕后,需要建立两者之间的绑定关系。服务商可登录服务商平台,【产品中心-> AppID管理】目录下即可完成绑定。
服务商模式下,一个APPID
下可绑定多个mchid
,一个mchid
可绑定3个APPID
。
4. 入驻子商户(特约商户进件)
官方详细操作指引
服务商可登录服务商平台进入【服务商功能】界面完成子商户入驻。服务商可根据业务需要,也可以使用特约商户进件接口,批量协助商家完成入驻。
大致流程为:
- 创建申请单,点击新增商户按钮,进入创建申请单流程
- 填写资料:包括:主体信息、经营信息、结算规则、结算账户、超级管理员
- 系统校验&人工审核,人工审核,约3-7个工作日完成
- 人工审核通过后,将根据申请单情况,判断是否需账户验证
- 超管完成账户验证
- 超管签约
- 开通权限
- 完成入驻
申请完成后,可以查看到微信支付下发的特约商户号。或者登录服务商平台新增商户按钮下的列表查看。
5. 配置API v3密钥(服务商)
官方详细操作指引
API v3密钥主要用于平台证书解密、回调信息解密,具体使用方式可参见接口规则文档中证书和回调报文解密章节。
登录微信服务商平台,进入【账户中心 > API安全】目录,设置APIV3密钥。
这个步骤和商户平台一致,可以参考配置API v3密钥。
6. 下载并配置商户证书
官方详细操作指引
商户API证书具体使用说明可参见接口规则文档中私钥和证书章节。服务商可登录微信服务商平台,在【账户中心 -> API安全】目录下载证书。
这个步骤和商户平台一致,可以参考下载并配置商户证书。
可以点击管理证书,查看证书序列号。
汇总
通过以上步骤,我们得到了下面这些参数、秘钥、证书。接下来就可以使用这些信息调用服务商API了。
名称 | 描述 |
---|---|
服务商户号 | 服务商户号,服务商的收款账号,微信下发到注册邮件查看 |
服务商应用ID | 服务商申请的公众号appid |
特约商户号 | 特约商户的商户号,服务商进件后微信支付生成,在特约商户申请列表查看,也可使用查询申请单状态API |
特约商户APPID | 在发起JSAPI支付(包括公众号,小程序),Native支付(非必填)、App支付等交易时,需传入特约商户对应类型的APPID,以完成支付,并获取sub_openid(这里没有申请,需要商家自己去申请) |
API V3秘钥 | 服务商API V3密钥 |
服务商证书文件 | apiclient_key.pem、apiclient_cert.pem |
证书序列号 | 服务商证书的序列号 |