# 支付联调

## Admin 支付配置（推荐）

管理后台 **支付配置** 页可一次性维护：

| 类别 | 项 |
|------|-----|
| 站点 | `site.base_url`（HTTPS 外网）、`site.front_base_url` |
| 前端展示 | `payment.display_channels`（默认 `alipay`；可 `alipay,wechat`） |
| 支付宝 | `app_id`、沙箱开关、`private_key`、`public_key` |
| 微信 | `app_id`、`mch_id`、`mch_serial_no`、沙箱标记、`mch_private_key`、`api_v3_key`、`platform_cert` |

保存参数写入 `settings` 表并热加载；密钥上传至 `backend-web/storage/payment/*.pem`。页顶就绪状态可查看缺项。

## 密钥文件（亦可直接放入 `storage/payment/`）

| 文件 | 用途 |
|------|------|
| alipay_private_key.pem | 支付宝商户私钥 |
| alipay_public_key.pem | 支付宝公钥 |
| wechat_mch_private_key.pem | 微信商户私钥 |
| wechat_api_v3_key.pem | APIv3 密钥（32 字节） |
| wechat_platform_cert.pem | 微信平台证书 |

## local.php 默认值

`local.php` / `local.php.example` 可预填上述项；Admin 中保存的值会覆盖同键配置。

## notify 路径

- `{site.base_url}/api/v1/pay/alipay/notify`
- `{site.base_url}/api/v1/pay/wechat/notify`

本地开发需 ngrok 等穿透；重复 notify 应幂等返回 success。