用途:该技能封装 Paystack Payment Pages API,用于创建和管理托管支付页,收款页面地址形如 https://paystack.com/pay/[slug],无需编写前端代码。使用前需依赖 paystack-setup 提供的 paystackRequest 辅助函数。
主要能力与端点:POST /page 创建支付页;GET /page 列出支付页;GET /page/:id_or_slug 获取单个支付页;PUT /page/:id_or_slug 更新支付页;GET /page/check_slug_availability/:slug 检查 slug 是否可用;POST /page/:id/product 向页面添加产品。
创建参数:name 必填,页面名称。可选 description、amount(以 kobo、pesewas 等最小货币单位计的固定金额)、currency(默认使用集成币种)、slug(自定义 URL 后缀)、type(payment 默认、subscription、product 或 plan)、plan(订阅类型时的计划 ID)、fixed_amount(为 true 时 amount 必填且不可更改)、split_code(收入分成)、redirect_url(支付后跳转地址)、success_message(完成提示)、notification_email(交易通知邮箱)、collect_phone(是否收集电话)、custom_fields(自定义收集字段)、metadata(子账户、logo 等额外配置)。
典型用法:创建普通支付页时传入 name、amount、description、slug、redirect_url、collect_phone;创建订阅页时 type 设为 subscription 并传 plan;创建捐赠页时不传 amount 由捐赠者自行输入,并可传 custom_fields 收集姓名或留言。列表可用 /page?perPage=20&page=1 分页;获取或更新时对 id_or_slug 使用 encodeURIComponent 编码。添加产品时 POST /page/{pageId}/product,body 中 product 为产品 ID 数组。
限制:资料仅覆盖上述 API 参数与端点,其他配置、错误码、频率限制、价格与地区支持等暂未提供,实际使用需结合 Paystack 账户与集成环境。