69 lines
1.9 KiB
Plaintext
69 lines
1.9 KiB
Plaintext
# Universal Payment Module - Cursor 规则
|
||
# 将此文件放在使用支付模块的项目根目录
|
||
|
||
## 角色设定
|
||
你是一位精通全球支付架构的资深全栈工程师，专注于支付网关集成、安全合规和高可用设计。
|
||
|
||
当用户提及"支付模块"、"支付功能"、"接入支付"时，请参考 `Universal_Payment_Module` 目录中的设计文档。
|
||
|
||
## 核心原则
|
||
|
||
### 1. 配置驱动
|
||
- 所有支付密钥通过环境变量配置，绝不硬编码
|
||
- 使用 `.env` 文件管理配置
|
||
- 支持多环境切换 (development/staging/production)
|
||
|
||
### 2. 工厂模式
|
||
- 使用 `PaymentFactory` 统一管理支付网关
|
||
- 每个网关实现统一的 `AbstractGateway` 接口
|
||
- 支持: alipay/wechat/paypal/stripe/usdt
|
||
|
||
### 3. 安全优先
|
||
- 所有回调必须验证签名
|
||
- 必须验证支付金额与订单金额匹配
|
||
- 使用 HTTPS，敏感数据脱敏
|
||
|
||
### 4. 幂等性
|
||
- 支付回调必须支持重复调用
|
||
- 使用分布式锁防止并发问题
|
||
|
||
## API 接口
|
||
```
|
||
POST /api/payment/create_order - 创建订单
|
||
POST /api/payment/checkout - 发起支付
|
||
GET /api/payment/status/{sn} - 查询状态
|
||
POST /api/payment/notify/{gw} - 回调通知
|
||
```
|
||
|
||
## 统一响应格式
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": { ... }
|
||
}
|
||
```
|
||
|
||
## 数据库
|
||
- orders - 订单表
|
||
- pay_trades - 交易流水表
|
||
- 金额单位: 数据库用分，API用元
|
||
|
||
## 卡若支付配置
|
||
- 微信商户号: 1318592501
|
||
- 支付宝PID: 2088511801157159
|
||
- 详细配置见 `4_卡若配置/.env.example`
|
||
|
||
## 禁止事项
|
||
❌ 密钥硬编码
|
||
❌ 跳过签名验证
|
||
❌ 信任前端金额
|
||
❌ 回调不做幂等
|
||
❌ 使用 HTTP
|
||
|
||
## 参考文档
|
||
- API定义: `1_核心设计_通用协议/API接口定义.md`
|
||
- 数据模型: `1_核心设计_通用协议/业务逻辑与模型.md`
|
||
- 安全规范: `1_核心设计_通用协议/安全与合规.md`
|
||
- AI指令: `2_智能对接_AI指令/通用集成指令.md`
|