> For the complete documentation index, see [llms.txt](https://proxypanel.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://proxypanel.gitbook.io/wiki/payment.md).

# 支付系统

## 支持支付渠道

* [x] 支付宝 面对面支付
* [x] 码支付
* [x] 易支付
* [x] PayJs
* [x] ~~MugglePay 麻瓜宝 (跑路了)~~
* [x] PayPal 
* [x] Stripe
* [x] PayBeaver 海狸支付
* [x] THeadPay 平头哥支付

## 使用

1. 访问：网站地址/admin/system#payment
2. 设置对应支付渠道的相关配置
3. 选填【通用支付回调地址】，【自定义商品名称】
4. 在【支付宝支付】【微信支付】【QQ钱包】【特殊支付】中选择渠道，以启用渠道

### 各渠道申请

* [支付宝面对面](https://open.alipay.com/platform/appManage.htm?#/create/)
* [码支付](https://codepay.fateqq.com/i/63779)
* 易支付：无；← 本支付为支付API框架，只要对应支付渠道声明支持易支付，即可使用本支付方式！
* [PayJs](https://payjs.cn/ref/zgxjnb)
* [麻瓜宝](https://merchants.mugglepay.com/basic/api)
* [PayPal](https://www.paypal.com/businessprofile/mytools/apiaccess/firstparty)
* [Stripe](https://dashboard.stripe.com/dashboard)
* [海狸支付](https://merchant.paybeaver.com/?aff_code=iK4GNuX8)
* [平头哥支付](https://theadpay.com/)

## 对接支付渠道教程

{% hint style="info" %}
下表中提及文件均可作为新对接文件的参考和代码规范资料！
{% endhint %}

| 文件地址                                            | 描述           |
| ----------------------------------------------- | ------------ |
| resources/views/admin/config/system.blade.php   | 【系统设置】前端页面   |
| app/Http/Controllers/Admin/SystemController.php | 【系统设置】后端控制文件 |
| app/Http/Controllers/Gateway/\*                 | 各渠道的对接文件     |
| app/Http/Controllers/PaymentController.php      | 支付系统总控制      |
| app/Models/Order.php                            | 支付显示标签       |

1. 在`app/Http/Controllers/Gateway/*`下添加新的支付渠道php文件；

   1. 该文件class推荐为 extends AbstractPayment，该文件存有大量必要function方程；

   2. 文件必含方程：purchase, notify; 

   > * purchase
   >
   >   ```
   >   // 获取商品信息建立面板在线订单
   >   $payment = $this->creatNewPayment(Auth::id(), $request->input('id'), $request->input('amount'));
   >   ```
   >
   >   从$payment 获取支付渠道需要的订单信息。建立渠线支付单，再对渠道返回信息进行储存或转跳处理。支付链接生成二维码保存到payment的qr\_code下（参考F2Fpay）或者保存url转跳至支付网站（参考Paypal）；
   > * notify：接受异步通知，进行必要的来源验证，订单成功状态验证等。
   >
   >   ```
   >   // 支付入账，开通服务
   >   $this->paymentReceived(string 面板payment的Trade No)
   >   ```
   >
   >   返回状态码，如果渠道需要状态码确认通知是否收到的话。
   >
   >   * 其中notify\_url/callback\_url等异步通知链接设置为
   >
   >     ```
   >     route('payment.notify', ['method' => '支付getPayment转跳名']),
   >     ```
2. 在`app/Http/Controllers/PaymentController.php`中`getClient()`添加支付方式转跳名；
3. 在`app/Http/Controllers/Admin/SystemController.php`中`getPayment()`支付设置判断 switch中 添加支付方式必填项目；
4. 可使用Laravel的`magration`工具，往数据库 config 表中加入必要的配置信息；
5. 在`resources/views/admin/config/system.blade.php`中添加配置设置；
6. `config/common.php`中`payment->labels`下添加支付方式转跳名与显示标签名。

大部分面板处理代码都已经精简细化，方便添加新的支付方式；有疑问可以开issue 😀