用途:该技能用于把 Polar 支付平台集成到 Web 项目中,Polar 面向数字产品提供订阅、一次性购买、许可、结账与 Webhook 能力。适合需要添加 Polar 支付、配置结账或订阅流程的场景。
主要能力:按框架选择适配方式,Polar 一等支持 Next.js(@polar-sh/nextjs)、SvelteKit(@polar-sh/sveltekit)、Supabase(@polar-sh/supabase)、任意 JS/TS 框架(@polar-sh/sdk)与 Python(polar-sdk),其他适配器还包括 Astro、Express、Hono、Fastify、Remix、Nuxt、Elysia、Deno、TanStack Start、Better Auth。覆盖结账方式选择(结账链接、结账 API、嵌入式结账)、Webhook 事件通知、客户门户,以及产品定价、试用、按席位定价、折扣、自定义字段、权益与许可密钥、用量计费与计量、订单订阅、退款、指标分析和 API 参考等主题。
使用方式:先确定项目技术栈,再安装依赖。示例命令:npm install @polar-sh/sdk;Next.js 项目 npm install zod @polar-sh/nextjs;SvelteKit 项目 npm install zod @polar-sh/sveltekit;Supabase 项目 npm install zod @polar-sh/supabase;嵌入式结账 npm install @polar-sh/checkout;Python 项目 pip install polar-sdk。注意 SDK 处于活跃开发中,建议固定版本,如 npm install @polar-sh/sdk@^0.46 或 pip install polar-sdk~=0.28。然后配置认证环境变量 POLAR_ACCESS_TOKEN 与 POLAR_WEBHOOK_SECRET,访问令牌从 Polar 后台组织设置创建。测试可使用 server: "sandbox",生产使用 server: "production" 或省略。结账可通过结账链接、结账 API 或嵌入式结账实现;Webhook 用于接收订单创建、订阅取消等事件;客户门户为可选能力,让客户管理订单与订阅。
适用场景与限制:适用于支持上述框架的项目接入 Polar 支付能力。具体各主题的详细步骤、测试卡信息、事件清单、限流与权限范围等需查阅对应参考文档;资料未提供自建后端的本地部署要求、定价方案与具体收费标准,暂未提供。