|
@@ -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
|