微信支付开发 · 微信开发SDK文档（新）

# 微信支付开发 [TOC] ## 🎯 什么是微信支付开发？微信支付开发就是让你的网站或应用能够收钱！用户可以通过微信支付来购买你的商品或服务。 **微信支付能做什么：** - 💰 **收钱** - 用户扫码就能付款 - 📊 **查订单** - 查看支付状态和详情 - 💸 **退款** - 给用户退钱 - 📢 **通知** - 支付成功后自动通知 - 🎁 **发红包** - 给用户发红包 - 💳 **转账** - 给用户转账 **简单来说：** 让你的网站变成一个"收银台"！ ## 🤔 为什么选择微信支付？ **传统支付的问题：** - 用户需要输入银行卡信息 - 支付流程复杂 - 用户担心安全问题 - 支付成功率低 **微信支付的优势：** - 用户直接用微信付款，超方便！ - 支付流程简单，只需扫码 - 微信背书，用户更信任 - 支付成功率高 ## 快速开始案例 ### 微信支付基础功能案例 ```php <?php // 微信支付开发案例 include "WeChatDeveloper/include.php"; $config = [ 'appid' => 'wx60a43dd8161666d4', 'appsecret' => 'your_wechat_appsecret', 'mch_id' => 'your_mch_id', 'mch_key' => 'your_mch_key', 'cache_path' => '/path/to/cache', ]; try { $wechat = \WePay\Order::instance($config); echo "=== 微信支付开发案例 ===\n"; // 测试统一下单功能 $options = [ 'body' => '测试商品', 'out_trade_no' => 'ORDER_' . time(), 'total_fee' => '100', 'openid' => 'o38gpszoJoC9oJYz3UHHf6bEp0Lo', 'trade_type' => 'JSAPI', 'notify_url' => 'https://your-domain.com/notify.php', 'spbill_create_ip' => '127.0.0.1', ]; echo "测试统一下单功能...\n"; $result = $wechat->create($options); if ($result['return_code'] === 'SUCCESS' && $result['result_code'] === 'SUCCESS') { echo "✓ 统一下单功能正常\n"; echo "预支付ID: " . $result['prepay_id'] . "\n"; } else { echo "✗ 统一下单功能异常: " . $result['return_msg'] . "\n"; } // 测试订单查询功能 echo "测试订单查询功能...\n"; $queryResult = $wechat->query(['out_trade_no' => $options['out_trade_no']]); if ($queryResult['return_code'] === 'SUCCESS') { echo "✓ 订单查询功能正常\n"; } else { echo "✗ 订单查询功能异常: " . $queryResult['return_msg'] . "\n"; } // 测试退款功能 echo "测试退款功能...\n"; $refund = \WePay\Refund::instance($config); $refundResult = $refund->create([ 'out_trade_no' => $options['out_trade_no'], 'out_refund_no' => 'REFUND_' . time(), 'total_fee' => '100', 'refund_fee' => '100', ]); if ($refundResult['return_code'] === 'SUCCESS') { echo "✓ 退款功能正常\n"; } else { echo "✗ 退款功能异常: " . $refundResult['return_msg'] . "\n"; } echo "✓ 所有微信支付功能测试完成\n"; } catch (Exception $e) { echo "✗ 微信支付功能测试失败: " . $e->getMessage() . "\n"; } ``` **接口说明：** - 微信支付开发的基础功能示例 - 展示统一下单、订单查询、退款等核心功能 - 验证V2和V3两套API的功能正常性 **注意事项：** - 确保商户号和密钥正确配置 - 需要配置正确的回调地址 - 建议先测试沙箱环境 ## 功能概述微信支付是微信生态中的核心支付解决方案，为商户提供了安全、便捷的支付服务。本模块支持微信支付的所有核心功能开发。 ## 核心功能 ### 基础功能 #### 公众号支付 - **功能描述**: 在微信公众号内完成支付 - **适用场景**: 公众号商城、服务付费、会员充值 - **主要特性**: 微信内支付、安全可靠、用户体验好 #### 统一下单 - **功能描述**: 创建微信支付订单 - **适用场景**: 商品购买、服务付费、充值缴费 - **主要特性**: 支持多种支付方式、订单管理、状态跟踪 #### 客户端发起支付 - **功能描述**: 前端发起支付请求 - **适用场景**: 网页支付、移动端支付 - **主要特性**: 跨平台支持、安全验证、用户友好 #### 查询订单 - **功能描述**: 查询支付订单状态 - **适用场景**: 订单管理、状态同步、异常处理 - **主要特性**: 实时查询、状态更新、异常监控 #### 关闭订单 - **功能描述**: 关闭未支付的订单 - **适用场景**: 订单超时、用户取消、系统清理 - **主要特性**: 自动关闭、手动关闭、状态管理 #### 申请退款 - **功能描述**: 处理用户退款申请 - **适用场景**: 退货退款、服务取消、异常处理 - **主要特性**: 全额退款、部分退款、退款审核 #### 查询退款 - **功能描述**: 查询退款状态和详情 - **适用场景**: 退款管理、状态跟踪、财务对账 - **主要特性**: 实时查询、详细记录、状态同步 #### 支付通知 - **功能描述**: 处理微信支付结果通知 - **适用场景**: 订单状态更新、业务逻辑处理 - **主要特性**: 异步通知、签名验证、状态同步 ### 高级功能 #### 红包管理 - **功能描述**: 发送和管理微信红包 - **适用场景**: 营销活动、节日祝福、奖励发放 - **主要特性**: 普通红包、裂变红包、企业红包 #### V3接口 - **功能描述**: 微信支付V3版本API - **适用场景**: 新项目开发、功能升级 - **主要特性**: 更安全的签名、更丰富的功能、更好的性能 ## 支付方式 ### 1. 公众号支付 - 用户在微信内完成支付 - 适用于公众号内购买场景 - 支持JSAPI支付方式 ### 2. 扫码支付 - 生成二维码供用户扫码支付 - 适用于PC端和移动端 - 支持Native支付方式 ### 3. APP支付 - 在移动应用中调用微信支付 - 适用于iOS和Android应用 - 支持APP支付方式 ### 4. H5支付 - 在手机浏览器中完成支付 - 适用于移动端网页 - 支持H5支付方式 ## 开发流程 ### 1. 准备工作 1. 申请微信支付商户号 2. 配置支付参数 3. 设置回调地址 4. 申请支付权限 ### 2. 基础开发 1. 配置支付参数 2. 实现统一下单 3. 处理支付回调 4. 实现订单查询 ### 3. 功能扩展 1. 集成退款功能 2. 实现红包功能 3. 添加V3接口支持 4. 完善异常处理 ### 4. 测试部署 1. 沙箱环境测试 2. 生产环境部署 3. 监控支付状态 4. 处理异常情况 ## 技术特性 ### 1. 安全机制 - 签名验证 - 数据加密 - 防重放攻击 - 异常监控 ### 2. 订单管理 - 订单创建和查询 - 状态跟踪和更新 - 异常处理和重试 - 数据统计分析 ### 3. 支付处理 - 多种支付方式 - 实时状态同步 - 异步通知处理 - 异常情况处理 ### 4. 退款管理 - 退款申请和处理 - 退款状态跟踪 - 退款数据统计 - 异常退款处理 ## 最佳实践 ### 1. 开发建议 - 遵循微信支付开发规范 - 实现完善的错误处理 - 做好数据备份和恢复 - 监控支付异常情况 ### 2. 安全防护 - 验证所有支付数据 - 使用HTTPS协议 - 定期更新密钥 - 记录操作日志 ### 3. 性能优化 - 合理使用缓存 - 异步处理任务 - 优化数据库查询 - 监控系统性能 ## 相关文档 - [公众号支付](微信支付-公众号支付.md) - [统一下单](微信支付-统一下单.md) - [客户端发起支付](微信支付-客户端发起支付.md) - [查询订单](微信支付-查询订单.md) - [关闭订单](微信支付-关闭订单.md) - [申请退款](微信支付-申请退款.md) - [查询退款](微信支付-查询退款.md) - [支付通知](微信支付-支付通知.md) - [红包管理](微信服务号-红包管理.md) - [V3接口](微信支付-V3接口.md)