支付集成技能

经过生产验证的支付处理方案，涵盖 SePay（越南银行）、Polar（全球 SaaS）、Stripe（全球基础设施）、Paddle（MoR 订阅）和 Creem.io（MoR + 授权许可）。

适用场景

• 支付网关集成（结账、处理）
• 订阅管理（试用、升级、计费）
• Webhook 处理（通知、幂等性）
• 二维码支付（VietQR、NAPAS）
• 软件授权许可（License，设备激活）
• 多供应商订单管理
• 收入分成与佣金

平台选型

快速参考

SePay

• references/sepay/overview.md — 认证、支持的银行
• references/sepay/api.md — API 端点、交易
• references/sepay/webhooks.md — Webhook 设置与验证
• references/sepay/sdk.md — Node.js、PHP、Laravel SDK
• references/sepay/qr-codes.md — VietQR 二维码生成
• references/sepay/best-practices.md — 生产环境模式

Polar

• references/polar/overview.md — 认证、MoR 概念
• references/polar/products.md — 定价模型
• references/polar/checkouts.md — 结账流程
• references/polar/subscriptions.md — 订阅生命周期管理
• references/polar/webhooks.md — 事件处理
• references/polar/benefits.md — 自动化权益交付
• references/polar/sdk.md — 多语言 SDK
• references/polar/best-practices.md — 生产环境模式

Stripe

• references/stripe/stripe-best-practices.md — 集成设计
• references/stripe/stripe-sdks.md — 服务端 SDK
• references/stripe/stripe-js.md — Payment Element 支付组件
• references/stripe/stripe-cli.md — 本地测试
• references/stripe/stripe-upgrade.md — 版本升级
• 外部文档：https://docs.stripe.com/llms.txt

Paddle

• references/paddle/overview.md — MoR、认证、实体 ID
• references/paddle/api.md — 产品、价格、交易
• references/paddle/paddle-js.md — 弹出层/内嵌结账
• references/paddle/subscriptions.md — 试用、升级、暂停
• references/paddle/webhooks.md — SHA256 签名验证
• references/paddle/sdk.md — Node、Python、PHP、Go SDK
• references/paddle/best-practices.md — 生产环境模式
• 外部文档：https://developer.paddle.com/llms.txt

Creem.io

• references/creem/overview.md — MoR、认证、全球支持
• references/creem/api.md — 产品、结账会话
• references/creem/checkouts.md — 无代码链接、店面
• references/creem/subscriptions.md — 试用、按席位计费
• references/creem/licensing.md — 设备激活
• references/creem/webhooks.md — 签名验证
• references/creem/sdk.md — Next.js、Better Auth 集成
• 外部文档：https://docs.creem.io/llms.txt

多供应商

• references/multi-provider-order-management-patterns.md — 统一订单管理、货币转换

脚本

• scripts/sepay-webhook-verify.js — SePay Webhook 验证
• scripts/polar-webhook-verify.js — Polar Webhook 验证
• scripts/checkout-helper.js — 结账会话生成器

核心能力

实施流程

详见 references/implementation-workflows.md 获取各平台的分步指南。

通用流程： 认证 -> 产品配置 -> 结账 -> Webhook -> 事件处理