用途:帮助开发者在项目中实现支付处理,可选 SePay(越南市场)或 Polar(全球 SaaS)两条路线。
主要能力:SePay 侧包括支付网关(QR、银行转账、银行卡)、带 Webhook 的银行账户监控、基于订单的虚拟账户、VietQR 生成 API,支持 44 家以上越南银行,速率限制 2 次/秒。Polar 侧包括 Merchant of Record(全球税务合规)、订阅生命周期管理、用量计费(事件与计量)、自动化权益交付(GitHub、Discord、许可证)、客户自助门户,并提供多语言 SDK,速率限制 300 次/分钟。
使用方式:先按需求选平台(越南本地或全球、支付类型),再按需逐步加载 references 目录下的文档——SePay 的 overview.md(认证与平台能力)、api.md 或 sdk.md(接入)、webhooks.md(支付通知)、qr-codes.md、best-practices.md;Polar 的 overview.md(认证与 MoR 概念)、products.md(产品与定价)、checkouts.md(结账流程)、subscriptions.md、webhooks.md、benefits.md、sdk.md、best-practices.md。Webhook 验证可复用 scripts/sepay-webhook-verify.js 与 scripts/polar-webhook-verify.js,checkout-helper.js 用于生成两平台的结账会话。落地步骤为:配置认证、设置产品与定价、实现结账流(托管、内嵌或 API 驱动)、配置并校验 Webhook、处理支付事件(成功、失败、退款),上线前在沙箱测试,再用平台分析做监控优化。
适用场景:支付网关集成、订阅管理与试用升级、Webhook 通知处理、QR 码支付(VietQR、NAPAS)、按量计费、自动化权益发放、客户门户、银行转账自动化、定价产品目录。
限制:资料未提供具体价格、费率与地区可用性细节;需按平台速率限制设计调用;不同平台能力与适用范围不同,需按业务所在市场选择。