SuperAPI AI 工具集

polar-billing

通用与其它

查看项目

更新于 10-16 05:46

技能介绍

用途:该技能面向 Polar 计费系统的开发工作,当涉及 Stripe 集成、订阅生命周期、结账流程或权益(benefit)发放时使用。它提供整体计费基础设施的说明,包括实体、流程与 Stripe 对接。

主要能力:

  • 核心实体说明:Checkout、CheckoutLink、Order、Subscription、Transaction、Payment、Refund、Customer、Product/ProductPrice、BillingEntry,含各字段类型与含义。
  • 实体关系图:组织、产品、客户、订阅、订单、钱包、折扣、账户与交易账本之间的关联。
  • 主要服务:SubscriptionService、OrderService、CheckoutService、PaymentService、RefundService、BenefitGrantService 的方法与职责。
  • Dramatiq 后台任务:订阅、订单、Stripe Webhook、权益、结账、打款、退款等任务的触发条件与动作。
  • Stripe 集成:Webhook 端点路径、已实现事件类型、Webhook 处理流程与 StripeService 方法。
  • 订阅生命周期:创建、周期续费、取消、试用流程。
  • 按比例计费(proration):发生场景、计算方式、行为选项与账目条目。
  • 权益与积分:权益类型、发放与撤销流程、计量积分。
  • 催款与支付重试、交易账本。

使用方式:文档以文件路径和方法名为索引,直接列出如 server/polar/models/checkout.py、server/polar/subscription/service.py 等位置及函数签名,可按图索骥定位代码。具体操作命令暂未提供。

适用场景:修改或排查 Polar 计费逻辑、对接 Stripe、处理订阅变更与退款、配置权益发放时参考。

限制:资料为面向开发者的内部指南,未提供安装命令、收费价格或外部使用步骤;部分内容(如计量积分示例)在原始资料中被截断。