微信支付宝个人收款对接实战教程
本文将手把手教你使用木瓦公益码支付（MUWA / Serein）系统，在五分钟内部署一套完整的个人微信支付宝收款自动化方案。全程无需营业执照，资金直达个人账户。
准备工作
- 一台能运行PHP的服务器（虚拟主机或VPS均可）
- 个人微信收款码和支付宝收款码图片
- 一个常用邮箱用于注册木瓦公益码支付账号
第一步：注册并配置收款码
访问木瓦公益码支付官网，使用邮箱注册账号。登录后台后，进入"收款码管理"页面，分别上传你的微信个人收款码和支付宝个人收款码。系统会自动识别并建立收款通道。
💡 建议同时上传多张收款码，系统会自动轮询使用，降低单码风控概率。
第二步：获取API凭证
在后台"API管理"页面，记录你的 AppID 和 AppSecret。同时配置回调通知地址，例如：
https://your-domain.com/notify.php
第三步：编写订单创建代码
创建 create_order.php 文件，内容如下：
// 木瓦公益码支付 - 创建订单示例
<?php
require_once 'vendor/autoload.php';
use Muwa\CodePay\Client;
$client = new Client([
'app_id' => 'YOUR_APP_ID',
'app_secret' => 'YOUR_APP_SECRET'
]);
$result = $client->createOrder([
'out_trade_no' => 'ORDER_' . time(),
'total_fee' => 100, // 1元 = 100分
'subject' => '测试商品',
'notify_url' => 'https://your-domain.com/notify.php'
]);
if ($result['code'] === 0) {
// 获取支付二维码地址，展示给用户
$qrCode = $result['data']['qr_code'];
echo "<img src='{$qrCode}'>";
}
第四步：编写回调处理代码
创建 notify.php 文件，用于接收木瓦系统的支付成功通知：
// 木瓦公益码支付 - 回调处理示例
<?php
$data = $_POST;
// 验证签名（防止伪造通知）
$sign = generateSign($data, 'YOUR_APP_SECRET');
if ($sign !== $data['sign']) {
http_response_code(400);
exit('sign error');
}
// 签名验证通过，处理业务逻辑
$outTradeNo = $data['out_trade_no'];
// TODO: 更新订单状态、自动发货、充值积分等
echo 'success'; // 必须返回 success
⚠️ 重要：回调接口必须返回纯文本 "success"，否则木瓦系统会认为通知失败并进行重试。
第五步：测试并上线
发起一笔1分钱的测试订单，使用微信或支付宝扫码支付。观察回调是否正常触发，订单状态是否正确更新。测试通过后，即可正式上线。
避坑指南
- 签名错误：确保参数排序正确，APP_SECRET不要泄露
- 回调收不到：检查服务器是否允许外网POST请求，防火墙是否拦截
- 订单匹配失败：确保顾客付款金额与订单金额完全一致（木瓦支持金额偏移配置）
- 收款码过期：定期检查并更新收款码图片
需要更详细的文档？查看完整API文档 →