# 7、微信商家转账到零钱V3接口
# vkPay.transfer
vk-pay的版本需 >= 1.14.1
注意
需要申请开通微信支付的【商家转账到零钱】接口,如下图所示
无框架下的云函数代码示例(该写法同时也适用于任何框架)
# 单笔模式
const vkPay = require("vk-uni-pay");
let transferRes = await vkPay.transfer({
//real_name: "真实姓名", // 真实姓名 大于2000元的转账需要填写真实姓名
amount: 1, // 100=1元(单位分)
title: "转账",
pay_type: "wxpay",
openid: "oJEy94iPPehudfKiHmdmaJqNOVD8",
remark: "转账备注",
out_biz_no: "test" + new Date().getTime(), // 转账单号(请自己控制全局唯一)
version: 3, // 固定3,代表使用v3版本
});
if (transferRes.code === 0) {
// 转账成功后的逻辑
} else {
// 转账失败后的逻辑
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 请求参数
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
real_name | 【特殊选填】对方真实姓名(转账大于2000元时必填) | String | - | - |
amount | 【必填】转账金额 100=1元(单位分),金额最低0.1元,也就是 amount >= 10 | Number | - | - |
title | 【必填】转账标题 | String | - | - |
pay_type | 【必填】固定 wxpay | String | - | wxpay |
remark | 【必填】转账备注 | String | - | - |
out_biz_no | 【必填】转账单号 | String | - | - |
openid | 【必填】微信专用 - 用户的openid,需要与配置中的appid对应或与appid参数对应 | String | - | - |
appid | 【选填】手动传appid,不填则自动从配置中获取 | String | - | - |
platform | 【选填】若传了platform,且没传appid,则appid从指定的platform中获取 | String | - | - |
pid | 【选填】多商户模式下的自定义商户id(等于vk-pay-config表的_id) 查看vk-pay-config表 (opens new window) | String | - | - |
# 批量模式
const vkPay = require("vk-uni-pay");
let out_biz_no = "test" + new Date().getTime();
let transfer_detail_list = [{
out_detail_no: out_biz_no + "1", // 该用户的转账子单号
transfer_amount: 50, // 该用户的转账金额 单位为分 100 = 1元
transfer_remark: "关羽的报销单", // 该用户的转账备注
openid: "xxxxxxxx", // 该用户的openid
//user_name: "关羽",
},
{
out_detail_no: out_biz_no + "2", // 该用户的转账子单号
transfer_amount: 50, // 该用户的转账金额 单位为分 100 = 1元
transfer_remark: "张飞的报销单", // 该用户的转账备注
openid: "xxxxxxxx", // 该用户的openid
//user_name: "张飞",
}
]
let transferRes = await vkPay.transfer({
out_biz_no, // 转账单号(请自己控制全局唯一)
batch_name: "2022年8月员工报销单", // 本次批量转账的名称
batch_remark: "2022年8月员工报销单", // 本次批量转账的备注
total_amount: 100, // 本次批量转账共转金额 单位为分 100 = 1元
total_num: transfer_detail_list.length, // 本次批量转账共几笔
transfer_detail_list, // 本次批量转账详情
pay_type: "wxpay", // 固定 wxpay
version: 3, // 固定3,代表使用v3版本
});
if (transferRes.code === 0) {
// 转账成功后的逻辑
} else {
// 转账失败后的逻辑
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# 请求参数
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
appid | 手动传appid,不填则自动从配置中获取 | String | - | - |
out_biz_no | 转账单号 | String | - | - |
batch_name | 本次批量转账的名称 | String | - | - |
batch_remark | 本次批量转账的备注 | String | - | - |
total_amount | 本次批量转账共转金额 单位为分 100 = 1元 | Number | - | - |
total_num | 本次批量转账共几笔 | Number | - | - |
transfer_detail_list | 本次批量转账详情 | Array | - | - |
pay_type | 固定wxpay | String | - | - |
version | 固定3,代表使用v3版本 | Number | - | - |
pid | 多商户模式下的自定义商户id(等于vk-pay-config表的_id) 查看vk-pay-config表 (opens new window) | String | - | - |
# 注意事项
- 新注册的微信商户号,转账接口的申请需要入驻满90天,且连续正常交易30天(刷单不算)
特别注意
微信转账接口配置
{
"wxpay":{
...其他配置
// 微信 - 转账到零钱 v3版本
"transfer": {
"appId": "",
"mchId": "",
"v3Key": "", // api v3密钥
"appCertPath": path.join(__dirname, 'wxpay/apiclient_cert.pem'), // 商家应用证书
"appPrivateKeyPath": path.join(__dirname, 'wxpay/apiclient_key.pem'), // 商家私钥证书
},
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
# 参数的获取方式
1、appId 微信appId:去微信后台查看。
2、mchId 微信支付商户id:去微信支付后台查看。
3、v3Key api v3的密钥:去微信支付后台查看。
4、appCertPath 商家应用证书(apiclient_cert.pem)的路径
5、appPrivateKeyPath 商家私钥证书(apiclient_key.pem)的路径
# 设置IP白名单
微信转账需要设置IP白名单,前往 微信支付后台 (opens new window) - 上方菜单产品中心 - 找到商家转账到零钱 - 设置
# 腾讯云空间
前往unicloud控制台,打开转账对应的云函数详情,开启固定IP即可。
# 阿里云空间
直接把下面的ip都加到微信支付后台 (opens new window)即可。
代理服务器IP列表
47.92.132.2
47.92.152.34
47.92.87.58
47.92.207.183
8.142.185.204
1
2
3
4
5
2
3
4
5
# 支付宝云空间
直接把下面的ip都加到微信支付后台 (opens new window)即可。
固定出口IP列表
47.97.38.108
112.124.10.115
1
2
2
注意:上面的IP是云端运行时的IP,若是本地运行云函数,则需要把自己电脑的外网IP加进去
注意:
- 1、只支持微信支付V3版本,不支持微信支付V2版本
- 2、转账前请保证微信支付商户号内有足够的余额(有些分运营账户和基本账户的,请充值到运营账户中,支出款项都由运营账户出资,下单收款都收到基本账户。)