# 微信支付连接器配置说明
# 连接器介绍
【微信支付】连接器对接微信商户号，支持通过连接器以企业的名义给企业内部人员转账。
# 业务场景
在某些场景下，需要以企业的名义给企业内部人员转账（如考勤奖励、员工关怀等），人员接收到转账消息后，需要到微信中领取，超过24小时未领取则过期。
# 运行端效果
- 触发连接器，成功进行微信转账
- 接收人在企微中接收到消息
- 接收人复制链接到微信打开
- 微信领取
# 连接器配置说明
# 配置前提
# 一、 开通企业支付
# 1、开通微信商户号
微信商户后台：https://pay.weixin.qq.com/ (opens new window)
1）点击"成为商家"（图1-1），根据接入指引进行操作
图1-1
# 2、开通"企业微信"产品功能
微信商户后台产品中心页面：https://pay.weixin.qq.com/index.php/extend/product/lists?tid=3 (opens new window)
1）点击"企业微信"开通功能（图2-1）
2）进入左侧"AppID账号管理"，点击右侧"+关联appID"按钮，输入企业微信corpId与公司主体名称进行应用绑定（图2-2），随后在企业微信管理后台"企业支付"应用进行绑定确认授权（图2-3）
图2-1
图2-2
图2-3
# 3、开通"商家转账"产品功能
微信商户后台产品中心页面：https://pay.weixin.qq.com/index.php/extend/product/lists?tid=3 (opens new window)
1）点击"商家转账"功能进行开通（图3-1），开通"佣金报酬"转账场景
2）开通后，点击"商家转账"->"前往功能"，配置接口IP白名单（图3-2），点击右侧"添加"按钮（图3-3），每次添加只能配置一个IP，多个IP需要添加多条数据（七巧低代码服务器IP信息请销售或技术支持提单向产研部门获取）
图3-1
图3-2
图3-3
# 4、配置并获取微信转账业务相关接口凭证
1）商户号
登录微信商户平台，点击【账户中心->账户设置->商户信息】，即可获取"微信支付商户号"
2）商户API证书文件
登录微信商户平台，进入【账户中心->账户设置->API安全】，根据"商户API证书"的操作指引https://kf.qq.com/faq/161222NneAJf161222U7fARv.html (opens new window)进行证书申请，最后本地生成的压缩包，解压后apiclient_key.pem即为商户API证书文件
3）API证书序列号
使用上一步生成的压缩包解压后的apiclient_cert.pem文件，在第三方的证书解析工具https://myssl.com/cert_decode.html (opens new window)中打开，获取"序列号"字段的数据
4）微信支付公钥证书文件
登录微信商户平台，进入【账户中心->账户设置->API安全】，根据"微信支付公钥"的操作指引https://pay.weixin.qq.com/doc/v3/merchant/4012153196 (opens new window)进行证书下载，证书文件名：pub_key.pem（注：若未切换为该验签方式，则一定要启用更换验签方式）
图一
图二
5）支付公钥ID
登录微信商户平台，进入【账户中心->账户设置->API安全】，点击"微信支付公钥"的查看进度，即可看到公钥ID
页面地址：https://pay.weixin.qq.com/index.php/core/cert/api_cert#/replace-key-step (opens new window)
6）APIV3密钥 登录微信商户平台，进入【账户中心->账户设置->API安全】，点击"APIv3密钥"设置按钮，进行APIV3密钥的设置（设置的密钥需妥善保存，设置后微信商户页面不再回显）
# 二、 安装连接器
在连接器市场-官方连接器中，安装【微信支付】连接器，若您的版本没有包含此连接器，可咨询您的客户经理。
# 三、配置企业支付账户
在配置微信支付连接器前，需要将对应的商户号以及转账业务所需凭证信息 (opens new window)配置在系统中，系统将获取对应商户号信息进行微信转账。
此入口会有权限控制，安装连接器后，超管可以在子账号设置中给子账号开启本配置入口，开启后对应的子账号才会有对应的权限配置。
由于此配置涉及到公司账户的安全，我们建议此配置只开放给部分人员，仅核心管理员开启此配置，配置完成后后续连接器可通过【商户号】调用企业支付。
# 配置入口
在支持配置连接器的入口可以配置此连接器。（执行前后的异步连接器事件不支持）
# 配置步骤
# 1. 请求事件
执行条件、筛选条件
配置当数据满足什么条件时才执行本连接器
接口请求
设置传入连接器的参数。
其中部分参数在用户接受消息时会显示：
请求参数说明：
| 参数 | 参数说明 | 字段类型 | 值类型 |
|---|---|---|---|
| mchId | 微信支付商户号，通过登录微信商户平台，点击【账户中心->商户信息】即可查看商户号 | 字符串 | 默认为微信支付商户号 |
| userId | 转账接受对象，仅支持选择单个人 | 字符串 | 通讯录userId |
| amount | 填写单次转账金额（单位：元） | 数字 | 整数或小数点后两位的小数 |
| msgTitle | 接收人收到消息通知的标题 | 字符串 | 消息通知标题 |
| msgRemark | 接收人接收时可查看转账说明 | 字符串 | 消息通知说明 |
| transferType | 接收人接收时查看转账类型，仅支持传特定的类型（当前仅支持"佣金报酬"） | 字符串 | 目前固定为：佣金报酬 |
# 2.同步返回事件
当调用微信支付连接器后，连接器会返回对应参数来确定是否有成功发起微信转账，可以将返回的参数插入或者更新到表单中。
同步返回参数说明：
| 参数 | 参数说明 | 字段类型 | 值类型 |
|---|---|---|---|
| userId | 转账接受对象，仅支持选择单个人 | 字符串 | 通讯录userId |
| amount | 填写单次转账金额（单位：元） | 数字 | 整数或小数点后两位的小数 |
| msgTitle | 接收人收到消息通知的标题 | 字符串 | 消息通知标题 |
| msgRemark | 接收人接收时可查看转账说明 | 字符串 | 消息通知说明 |
| transferType | 接收人接收时查看转账类型，仅支持传特定的类型（当前仅支持"佣金报酬"） | 字符串 | 目前固定为：佣金报酬 |
| billNumber | 转账单号（全局唯一） | 字符串 | 全局唯一单号，用该参数标识转账账单 |
| transferTime | 转账时间 | 毫秒级时间戳 | 时间戳 |
| transferStatus | 转账状态 | 字符串 | 固定为：success |
# 3. 异步返回事件
当调用微信支付连接器成功发起微信转账后，对应接收人领取转账/过期未领取等，会回调到系统，可以通过回调事件处理返回的数据。
回调参数：
| 参数 | 参数说明 | 字段类型 | 值类型 |
|---|---|---|---|
| tenantId | 企业租户id | 字符串 | 企业租户id |
| billNumber | 转账单号（全局唯一） | 字符串 | 全局唯一单号，用该参数标识转账账单 |
| operationUserId | 触发转账用户通讯录用户id | 字符串 | 通讯录userId |
| userId | 收款人通讯录用户id | 字符串 | 通讯录userId |
| amount | 填写单次转账金额（单位：元） | 数字 | 整数或小数点后两位的小数 |
| callbackStatus | 收款状态 | 字符串 | 成功：success，失败：fail，超时：timeout |
| callbackTime | 回调时间 | 毫秒级时间戳 | 时间戳 |
# 日志管理
系统将记录所有转账的日志，您可以在连接器中查看微信转账的情况。
入口：数据&集成-我的连接器-微信支付
# 异常情况说明：
- 本转账24小时过期，超过24小时未领取，则无法继续领取
- 在成功发起后运营账号就会扣取费用，若24小时内用户未领取，则会返回到运营账号