# 支付（`larablog/payment`）

支付基础能力：订单、流水、权益，以及后台订单工具。当前网关为 **Stub 模拟支付**，用于打通下单与开通流程。

## 启用

1. 从磁盘同步插件（`php artisan plugins:sync`，或后台 → 插件 → 同步磁盘插件）。
2. 启用 **支付**（`larablog/payment`）。
3. 执行迁移，创建插件表：

```bash
php artisan migrate
```

会创建：`orders`、`order_items`、`entitlements`、`payment_transactions`。

## Stub 结账流程

必须先登录。

```text
GET /plugins/payment/checkout
  ?product_type=article
  &product_id=1
  &title=示例文章
  &amount=9.90
  &currency=CNY
  &return_url=/
```

流程：

1. 创建一张 `pending` 订单（含一条明细）；若该商品已有有效权益，则提示错误、不重复建单。
2. 跳转到 `/plugins/payment/orders/{id}` 确认页。
3. 点击 **模拟支付成功** → `POST .../pay`：标记已支付、写入流水、开通权益，并触发 `order.paid`。
4. 跳回 `return_url`（仅允许本站同源地址），否则回首页。

## 后台

启用本插件后会出现：

- **订单** — 查看订单列表与详情
- **标记已支付** — 在待支付订单详情页
- **支付说明** — 本页（插件使用说明）

## 说明

- 本期网关固定为 `stub`。
- `product_type` 预留：`article`、`theme`、`membership`。
- 微信 / 支付宝 / Stripe 等真实网关不在本期范围。
