SuperAPI AI 工具集

paystack-subscriptions

编程与开发

查看项目

更新于 10-16 07:59

技能介绍

用途:通过 Paystack 订阅 API 创建和管理周期性付款。订阅将客户与套餐关联,并按套餐周期自动扣款。

主要能力与端点:POST /subscription 创建订阅(必填 customer、plan,可选 authorization、start_date);GET /subscription 列表(perPage、page、customer、plan 过滤);GET /subscription/:id_or_code 获取详情(含发票、客户、套餐、授权);POST /subscription/enable 启用;POST /subscription/disable 停用自动续费;GET /subscription/:code/manage/link 生成卡片更新链接;POST /subscription/:code/manage/email 邮件发送更新链接。

使用方式:依赖 paystack-setup 的 paystackRequest,例如 await paystackRequest("/subscription", { method: "POST", body: JSON.stringify({ customer: "CUS_xnxdt6s1zg1f4nx", plan: "PLN_gx2wn530m0i3w3m" }) })。创建后需保存 subscription_code 与 email_token,后者用于启用/停用。可用 start_date 延迟首次扣款。监听 subscription.expiring_cards 等 webhook 主动发送卡片更新链接。

限制与注意:客户须至少有一次有效授权(来自此前扣款)才能订阅;套餐更新需 update_existing_subscriptions: true 才能传播到活动订阅。