支付系统文档索引
欢迎使用 NEXTY.DEV 支付系统文档！本文档提供了完整的支付系统使用指南，从基础概念到高级功能，帮助你快速上手和深入理解。
文档结构
文档采用"由面到点"的结构，从整体概述开始，逐步深入到各个具体功能模块。
核心文档
- 系统架构介绍
- 核心特性说明
- 数据库表结构
- 核心模块说明
- 支付流程概览
- 定价计划数据结构
- 创建和管理定价计划
- 多语言支持
- 权益配置
- 支付提供商配置
- 完整的支付流程说明
- 结账会话创建
- 支付验证
- 错误处理
- 安全考虑
- Stripe Webhook 处理
- Creem Webhook 处理
- 事件类型说明
- Webhook 测试和调试
- 积分类型说明
- 积分授予机制
- 积分使用和扣除
- 积分撤销
- 积分日志查询
- 订单查询和管理
- 订阅状态同步
- 客户门户使用
- 积分历史查询
快速开始
新用户指南
如果你是第一次使用 NEXTY.DEV 支付系统，建议按以下顺序阅读：
- 第一步: 阅读 支付系统概述，了解整体架构
- 第二步: 阅读 定价计划管理，学习如何创建定价计划
- 第三步: 阅读 支付流程详解，理解支付流程
- 第四步: 阅读 Webhook 处理机制，了解 Webhook 配置
- 第五步: 阅读 积分系统，学习积分管理
- 第六步: 阅读 订单和订阅管理，掌握订单和订阅管理
按需求查找
我想创建定价计划
→ 定价计划管理
我想了解支付流程
→ 支付流程详解
我想配置 Webhook
我想管理积分系统
→ 积分系统
我想查询订单和订阅
→ 订单和订阅管理
我想了解系统架构
→ 支付系统概述
功能特性
支持的功能
- 多支付提供商（Stripe、Creem）
- 一次性支付和订阅支付
- 月度订阅和年度订阅
- 积分系统（一次性积分和订阅积分）
- 多语言支持
- 优惠券和折扣码
- 客户门户集成
- Webhook 自动处理
- 订单和订阅管理
- 积分历史查询
环境变量配置
Stripe
STRIPE_SECRET_KEY=sk_...
STRIPE_WEBHOOK_SECRET=whsec_...
STRIPE_CUSTOMER_PORTAL_URL=/dashboard/subscriptionCreem
CREEM_API_KEY=your_api_key
CREEM_WEBHOOK_SECRET=your_webhook_secret
CREEM_API_BASE_URL=https://api.creem.io/v1 # 可选其他
NEXT_PUBLIC_PRICING_PATH=/pricing
NEXT_PUBLIC_SITE_URL=https://yourdomain.com
[email protected]常见问题
Q: 如何开始使用支付系统？
A: 首先配置环境变量，然后创建定价计划，最后配置 Webhook。详细步骤请参考各文档。
Q: 支持哪些支付提供商？
A: 目前支持 Stripe 和 Creem 两个支付提供商。
Q: 如何测试支付功能？
A: 使用支付提供商的测试模式，并配置 Webhook 转发。详细说明请参考 Webhook 处理机制。
Q: 积分系统是如何工作的？
A: 积分系统支持一次性积分和订阅积分两种类型。详细说明请参考 积分系统。
Q: 如何管理用户的订阅？
A: 用户可以通过客户门户管理订阅，管理员可以通过 API 查询订阅状态。详细说明请参考 订单和订阅管理。