Преглед на файлове

docs(wechatpay): 添加微信支付扩展包完整使用文档

- 新增功能特性说明,包括订单创建、支付通知、订单查询等
- 补充安装指南和配置参数详细说明
- 提供支付订单创建、回调处理、状态查询等代码示例
- 添加退款申请与查询功能使用方法
- 完善技术联系方式和支持信息
runphp преди 3 месеца
родител
ревизия
1bb4a5a985
променени са 1 файла, в които са добавени 90 реда и са изтрити 0 реда
  1. 90 0
      README.md

+ 90 - 0
README.md

@@ -1,2 +1,92 @@
 # 微信支付
 
+微信支付扩展包,为 SixShop 商城系统提供微信支付功能支持。
+
+## 功能特性
+
+- 微信支付订单创建
+- 支付结果异步通知处理
+- 支付订单查询
+- 退款申请与查询
+- 发货信息上传
+- 运单信息跟踪
+
+## 安装
+
+```bash
+composer require six-shop/wechatpay
+```
+
+## 配置说明
+
+在后台管理系统中配置以下参数:
+
+| 参数 | 说明 | 是否必填 |
+|------|------|---------|
+| mchid | 商户号 | 是 |
+| appid | 开发者ID | 否 |
+| apiclient_cert | 商户API证书 | 否 |
+| apiclient_key | 商户API私钥 | 否 |
+| serial_no | 商户API证书序列号 | 否 |
+| public_key | 微信支付公钥 | 否 |
+| public_key_id | 微信支付公钥ID | 否 |
+| api_v3_key | APIv3密钥 | 否 |
+| platform_no | 平台证书序列号 | 否 |
+| platform_cert | 平台证书 | 否 |
+| sandbox | 是否启用沙箱环境 | 否 |
+| notify_url | 支付回调地址 | 是 |
+| refund_notify_url | 退款回调地址 | 否 |
+
+## 使用方法
+
+### 创建支付订单
+
+```php
+$provider = app(\SixShop\WechatPay\PaymentProvider::class);
+$response = $provider->create($orderData, PaymentBizEnum::ORDER);
+```
+
+### 处理支付回调
+
+```php
+// 在控制器中处理微信支付回调
+public function notify(PaymentManager $paymentManager): Response
+{
+    $requestData = [
+        'headers' => getallheaders(),
+        'inBody' => file_get_contents('php://input'),
+    ];
+    
+    $result = $paymentManager->getPaymentProvider('wechatpay')->notify($requestData);
+    return success_response(msg: '回调成功');
+}
+```
+
+### 查询支付状态
+
+```php
+$provider = app(\SixShop\WechatPay\PaymentProvider::class);
+$result = $provider->query($recordID);
+```
+
+### 申请退款
+
+```php
+$provider = app(\SixShop\WechatPay\PaymentProvider::class);
+$refundRequest = new PaymentRefundRequest($amount, $reason);
+$result = $provider->refund($recordID, $refundRequest);
+```
+
+### 查询退款状态
+
+```php
+$provider = app(\SixShop\WechatPay\PaymentProvider::class);
+$result = $provider->refundQuery($refundID);
+```
+
+## 技术支持
+
+如有问题请联系:
+
+- 邮箱: runphp@qq.com
+- 作者: hui he