EasyWechat 4.x 微信小程序企业付款到零钱

1. 前言

---

单次提现金额要求在 0.3 元 - 5000 元之间

企业付款到零钱需要使用商户证书, 当配置的证书错误时会抛出异常, 而不是以返回值的形式返回

EasyWechat 4.x 企业付款 : https://easywechat.com/docs/4.x/payment/transfer

微信支付开发文档 : https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=14_1

2. 执行提现

---

特别注意: 证书配置错误时会抛出异常, 而不是以返回值的形式返回

use EasyWeChat\Factory;

$config = [
	// 必要配置
	'app_id' => 'xxxx',//小程序APPID
	'mch_id' => 'your-mch-id',//商户ID
	'key'    => 'key-for-signature',   // 商户API 密钥

    // 如需使用敏感接口（如企业付款、退款、公众号发送现金红包等）需要配置 API 证书
	'cert_path' => 'path/to/your/cert.pem', // XXX: 绝对路径！！！！
	'key_path'  => 'path/to/your/key',      // XXX: 绝对路径！！！！
];

$app = Factory::payment($config);

// 执行企业付款到零钱
$result = $app->transfer->toBalance([
	'partner_trade_no' => '1233455', // 商户订单号，具有唯一性(只能是字母或者数字)
	'openid'           => 'oxTWIuGaIt6gTKsQRLau2M0yL16E', // 提现用户openid
	'check_name'       => 'NO_CHECK', // NO_CHECK：不校验姓名, FORCE_CHECK：强校验真实姓名
	're_user_name'     => '王小帅', // 如果 check_name 设置为FORCE_CHECK，则必填用户真实姓名
	'amount'           => 10000,  // 企业付款金额，单位为分
	'desc'             => '提现', // 企业付款操作说明信息。必填
]);

3. 提现成功返回值

---

return_code 通信标识, 表示接口是否请求成功, 而不是交易标识, 不能用于判断提现结果

result_code 业务结果标识, 当其值为 SUCCESS 时表示 提现成功

执行提现应使用try catch捕获错误, 因为当证书文件错误时是抛出异常, 而不是以返回值的形式返回

try {
	$result = $app->transfer->toBalance();
} catch (\Throwable $e) {
	fault($e->getMessage());
}

if ( !empty($result['result_code']) && $result['result_code'] === 'SUCCESS') {
	// 提现成功
} else {
	// 提现失败
}

[
	'return_code'      => 'SUCCESS',
	'return_msg'       => NULL,
	'mch_appid'        => 'wxb80ec74221f8a9ff',
	'mchid'            => '1538483281',
	'nonce_str'        => '60af3d9658162',
	'result_code'      => 'SUCCESS',
	'partner_trade_no' => 'TX202105271435025469',
	'payment_no'       => '10101052430722105279091545815496',
	'payment_time'     => '2021-05-27 14:34:59',
]

4. 提现失败返回值 (常见场景)

---

开启检验用户名并且验证失败时

[
	'return_code'  => 'SUCCESS',
	'return_msg'   => '参数错误：没有找到对应校验用户姓名选项.',
	'result_code'  => 'FAIL',
	'err_code'     => 'PARAM_ERROR',
	'err_code_des' => '参数错误：没有找到对应校验用户姓名选项.',
]

提现金额小于 0.3 元

[
	'return_code'  => 'SUCCESS'
	'return_msg'   => '支付失败'
	'mch_appid'    => 'wxb80ec74221f8a9ff'
	'mchid'        => '1538483281'
	'result_code'  => 'FAIL'
	'err_code'     => 'AMOUNT_LIMIT'
	'err_code_des' => '付款金额超出限制。低于最小金额0.30元或累计超过5000.00元。'
]