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'       => 'FORCE_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元。'
]