easywechat

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

使用微信公众号发送红包，需要先为对应的公众号申请开通微信支付权限，设置好商户密钥并下载证书文件以备接口调用时使用。

强烈建议先阅读微信商户平台中红包功能相关的文档后再使用本SDK中相关方法。查看文官文档>https://pay.weixin.qq.com/wiki/doc/api/cash_coupon.php?chapter=13_1

##发送红包微信公众号红包分为现金红包和裂变红包，均可使用send方法完成，send方法中第二个参数表示发送的红包类型。

###注意发送不同类型红包时的参数有所区别，请仔细参考官方文档中的参数列表。 nonce_str、mch_id、wxappid、client_ip以及amt_type参数本SDK将自动赋值，数据的签名sign也由SDK自动完成，您只需设置好其余参数即可。

###示例

<?php

use Overtrue\Wechat\Payment\Business;
use Overtrue\Wechat\LuckMoney;

/**
* 第 1 步：定义商户
*/
$business = new Business(
APP_ID,
APP_KEY,
MCH_ID,
MCH_KEY
);

/**
* 第 2 步：设置证书路径
* CLIENTCERT_PATH即证书apiclient_cert.pem的路径
* CLIENTkey_PATH即证书apiclient_key.pem的路径
*/
$business->setClientCert('CLIENTCERT_PATH');
$business->setClientKey('CLIENTKEY_PATH');

/**
* 第 3 步：创建LuckMoney实例
*/
$luckMoneyServer = new LuckMoney($business);

/**
* 第 4 步：要发送的红包相关数据（本代码以发送现金红包为例）
*/
$luckMoneyData['mch_billno'] = time();  //红包记录对应的商户订单号
$luckMoneyData['send_name'] = '某某公司';  //红包发送者名称
$luckMoneyData['re_openid'] = 'oJCvDjjQKx5LMtM_1kjK0gGQLsew';  //红包接收者的openId
$luckMoneyData['total_amount'] = 100;  //红包总额（单位为分），现金红包至少100，裂变红包至少300
$luckMoneyData['total_num'] = 1;  //现金红包时为1，裂变红包时至少为3
$luckMoneyData['wishing'] = '祝福语';
$luckMoneyData['act_name'] = '活动名称';
$luckMoneyData['remark'] = '红包备注';

/**
* 第 5 步：发送红包
* 第二个参数表示发送的红包类型，有现金红包（'TYPE_CASH_LUCK_MONEY'）和裂变红包（'TYPE_GROUP_LUCK_MONEY'）可选，红包工具类中已定义相关常量。
*/
$result = $luckMoneyServer->send($luckMoneyData, Overtrue\Wechat\LuckMoney::TYPE_CASH_LUCK_MONEY);

var_dump($result);

##查询红包信息

该方法方便开发者查询红包的发送与用户领取红包的信息。现金红包和裂变红包信息的查询都可使用该方法。

###示例

<?php

use Overtrue\Wechat\Payment\Business;
use Overtrue\Wechat\LuckMoney;

/**
* 第 1 步：定义商户
*/
$business = new Business(
APP_ID,
APP_KEY,
MCH_ID,
MCH_KEY
);

/**
* 第 2 步：设置证书路径
* CLIENTCERT_PATH即证书apiclient_cert.pem的路径
* CLIENTkey_PATH即证书apiclient_key.pem的路径
*/
$business->setClientCert('CLIENTCERT_PATH');
$business->setClientKey('CLIENTKEY_PATH');

/**
* 第 3 步：创建LuckMoney实例
*/
$luckMoneyServer = new LuckMoney($business);

/**
* 第 4 步：查询红包
* 参数库红包记录对应的商户订单号
*/
$luckMoneyInfo = $luckMoneyServer->query('1234567');

var_dump($luckMoneyInfo);

中文版 English

中写在前面
EN 升级日志
EN 路线图
基本使用
功能与服务
- EN 用户与用户组管理
- EN 客服管理与发送消息
- EN 多客服的消息转发
- EN 网页授权
- EN 模板消息
- EN 自定义菜单
- EN 素材管理
- EN 卡券
- EN 门店
- EN JSSDK
- EN 二维码
- EN 短链接
- EN 微信支付
- EN 微信红包
- EN 语义理解服务
- EN 数据统计查询服务
其它
- EN 错误处理
- EN 自定义缓存

中文版 English

目录

English 中文版

Table of Contents