极地生产商
该连接器回填Polar客户、结帐、订单、订阅、
退款、产品和折扣。
它有现场活动 POST /webhooks/polar.
配置
| 变量 | 要求 | 默认的 |
|---|---|---|
POLAR_ACCESS_TOKEN | 是 | 无 |
POLAR_WEBHOOK_SECRET | 是 | 无 |
POLAR_API_BASE_URL | 托管只 | 无 |
POLAR_ORGANIZATION_ID | 否 | 无 |
设置
创建一个 极性组织访问令牌
与 customers:read， checkouts:read， orders:read， subscriptions:read，
refunds:read， products:read, discounts:read。使用它作为
POLAR_ACCESS_TOKEN.
为创建一个webhook端点 /webhooks/polar 并使用其签名密钥为
POLAR_WEBHOOK_SECRET。沙盒令牌和webhook必须来自Polar
沙箱。订阅 customer.*， checkout.*， order.*，
subscription.*， refund.*， product.*, discount.* 事件。这个
连接器确认其他事件，但不存储它们。
API版本
连接器引脚Polar API版本 2026-10 与 Polar-Version 头。
设置webhook端点API版本为 2026-10.
限制
删除的产品保留在 products 表，因为Polar没有
product.deleted webhook。订阅没有 started_at 可以错过
因为Polar对它们没有稳定的排序。回填后,
更新依赖于webhook。错过的webhook交付尚未恢复。
演示数据
pnpm demo --size 128MiB 在没有Polar标记的情况下写入虚构的Polar数据。看到
连接器套件README中的标志和它需要的变量。
每个客户都有指向的结帐、订阅、订单和退款
彼此订有固定的6种产品目录和3种折扣。 products 和
discounts 不要随尺寸而变大。
地方发展
沙盒使用Polar沙盒API。
cd connectors/producer-polar
pnpm sandbox
承载运行从 AIRFOIL_CONFIG_PATH。它还需要
Connector Kit README中的Wings和PostgreSQL变量。
cd connectors/producer-polar
pnpm start