⚡

支付集成Skill payment-integration

这个技能用于集成支付处理系统，特别是针对越南市场的SePay支付网关和全球SaaS货币化的Polar平台。它支持多种支付方式如QR码、银行转账、卡支付，以及订阅管理、基于用量的计费、自动化福利交付、webhook处理、客户门户和税务合规。适用于开发支付系统、计费系统和客户自助服务平台，关键词包括支付集成、SePay、Polar、订阅管理、webhook、QR码支付、自动化福利、税务合规和SDK集成。

支付系统 0 次安装 0 次浏览 更新于 3/14/2026

名称: payment-integration 描述: 实现与SePay（越南支付网关，支持VietQR、银行转账、卡支付）和Polar（全球SaaS货币化平台，支持订阅、基于用量的计费、自动化福利）的支付集成。用于集成支付处理、实施结账流程、管理订阅、处理webhooks、处理银行转账、生成QR码、自动化福利交付或构建计费系统。支持身份验证（API密钥、OAuth2）、产品管理、客户门户、税务合规（Polar作为记录商户）和全面的SDK集成（Node.js、PHP、Python、Go、Laravel、Next.js）。 版本: 1.0.0 许可证: MIT

支付集成

实现与SePay（越南支付）和Polar（全球SaaS货币化）的支付处理。

何时使用

在实施以下功能时使用：

  • 支付网关集成（结账、处理）
  • 订阅管理（试用、升级、计费）
  • Webhook处理（支付通知）
  • QR码支付（VietQR、NAPAS）
  • 基于用量的计费（计量、积分）
  • 自动化福利交付（许可证、GitHub访问、Discord角色）
  • 客户门户（自助服务管理）
  • 银行转账自动化（越南银行）
  • 带定价的产品目录

平台选择

选择SePay用于：

  • 越南市场（VND货币）
  • 银行转账自动化
  • VietQR/NAPAS支付
  • 本地支付方式
  • 直接银行账户监控

选择Polar用于：

  • 全球SaaS产品
  • 订阅管理
  • 基于用量的计费
  • 自动化福利（GitHub、Discord、许可证）
  • 记录商户（税务合规）
  • 数字产品销售

快速参考

SePay集成

  • 概述与身份验证: references/sepay/overview.md - 平台能力、API/OAuth2身份验证、支持的银行
  • API参考: references/sepay/api.md - 端点、交易、银行账户、虚拟账户
  • Webhooks: references/sepay/webhooks.md - 设置、负载结构、验证、重试逻辑
  • SDK使用: references/sepay/sdk.md - Node.js、PHP、Laravel实现
  • QR码: 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 - 生命周期、升级、降级、试用
  • Webhooks: references/polar/webhooks.md - 事件类型、签名验证、监控
  • 福利: references/polar/benefits.md - 自动化交付（GitHub、Discord、许可证、文件）
  • SDK使用: references/polar/sdk.md - TypeScript、Python、PHP、Go、框架适配器
  • 最佳实践: references/polar/best-practices.md - 安全、模式、监控

集成脚本

  • SePay Webhook验证: scripts/sepay-webhook-verify.js - 验证SePay webhook真实性
  • Polar Webhook验证: scripts/polar-webhook-verify.js - 验证Polar webhook签名
  • 结账助手: scripts/checkout-helper.js - 为两个平台生成结账会话

实施工作流

SePay实施

  1. 加载 references/sepay/overview.md 进行身份验证设置
  2. 加载 references/sepay/api.md 或 references/sepay/sdk.md 进行集成
  3. 加载 references/sepay/webhooks.md 进行支付通知
  4. 使用 scripts/sepay-webhook-verify.js 进行webhook验证
  5. 加载 references/sepay/best-practices.md 进行生产准备

Polar实施

  1. 加载 references/polar/overview.md 进行身份验证和概念
  2. 加载 references/polar/products.md 进行产品设置
  3. 加载 references/polar/checkouts.md 进行支付流程
  4. 加载 references/polar/webhooks.md 进行事件处理
  5. 使用 scripts/polar-webhook-verify.js 进行webhook验证
  6. 加载 references/polar/benefits.md 如果自动化交付
  7. 加载 references/polar/best-practices.md 进行生产准备

关键能力

SePay:

  • 支付网关（QR码、银行转账、卡支付）
  • 带webhooks的银行账户监控
  • 基于订单的虚拟账户
  • VietQR生成API
  • 支持44+越南银行
  • 速率限制: 2次调用/秒

Polar:

  • 记录商户（全球税务合规）
  • 订阅生命周期管理
  • 基于用量的计费（事件、计量器）
  • 自动化福利（GitHub、Discord、许可证）
  • 客户门户（自助服务）
  • 多语言SDK
  • 速率限制: 300次请求/分钟

指令

当实施支付集成时：

  1. 根据需求识别平台（越南vs全球，支付类型）
  2. 按需加载相关参考以保持上下文效率
  3. 使用平台特定方法实施身份验证
  4. 根据业务模型设置产品/定价
  5. 实施结账流程（托管式、嵌入式或API驱动）
  6. 配置webhooks并进行适当验证
  7. 处理支付事件（成功、失败、退款）
  8. 在生产前在沙盒中彻底测试
  9. 使用平台分析监控和优化 仅加载当前实施步骤所需的参考以保持上下文效率。