用途:实现支付处理集成,支持 SePay(越南本地支付)与 Polar(全球 SaaS 变现)两类平台。适用场景包括支付网关集成(结账、处理)、订阅管理(试用、升级、账单)、Webhook 处理(支付通知)、二维码支付(VietQR、NAPAS)、按量计费(计量、额度)、自动化权益发放(许可证、GitHub 访问、Discord 角色)、客户自助门户、越南银行转账自动化,以及带定价的产品目录。
平台选择:SePay 适合越南市场(VND)、银行转账自动化、VietQR/NAPAS 与本地支付方式、直接监控银行账户;Polar 适合全球 SaaS、订阅管理、按量计费、自动化权益(GitHub、Discord、许可证)、作为 Merchant of Record 处理税务合规及数字商品销售。
主要能力:SePay 提供支付网关(QR、银行转账、银行卡)、带 Webhook 的银行账户监控、基于订单的虚拟账户、VietQR 生成 API,支持 44+ 家越南银行,速率限制 2 次/秒。Polar 提供 Merchant of Record 全球税务合规、订阅生命周期管理、按量计费(事件、计量)、自动化权益发放、客户门户及多语言 SDK,速率限制 300 请求/分钟。
使用方式:按需渐进加载参考文档。SePay 流程为加载 references/sepay/overview.md 配置认证,加载 api.md 或 sdk.md 集成,加载 webhooks.md 处理通知,用 scripts/sepay-webhook-verify.js 校验 Webhook,最后加载 best-practices.md 达到生产就绪。Polar 流程为加载 overview.md 了解认证与概念,products.md 设置产品,checkouts.md 实现支付流程,webhooks.md 处理事件,用 scripts/polar-webhook-verify.js 校验签名,如需自动交付加载 benefits.md,最后加载 best-practices.md。另有 scripts/checkout-helper.js 为两平台生成结账会话。
限制:资料未提供具体价格、收费与完整代码示例;实现前需在沙箱充分测试,并注意各平台速率限制。