用途:该技能封装 Paystack Transactions API,用于在集成中创建和管理支付交易,覆盖从初始化到验证的完整生命周期。依赖 paystack-setup 提供的 paystackRequest 辅助函数与环境配置。
主要能力与端点:POST /transaction/initialize 初始化交易,返回 authorization_url 与 access_code;GET /transaction/verify/:reference 验证交易;GET /transaction 列出交易;GET /transaction/:id 获取单笔交易;POST /transaction/charge_authorization 对已保存授权扣款;GET /transaction/timeline/:id_or_reference 查看时间线;GET /transaction/totals 获取汇总;GET /transaction/export 导出 CSV;POST /transaction/partial_debit 部分扣款。
使用方式:初始化时 amount 以最小货币单位(如 kobo)传字符串,email 必填,可选 reference、currency、callback_url、channels、plan、metadata、subaccount、split_code 等。服务端初始化后,可用返回的 authorization_url 重定向,或用 access_code 配合 @paystack/inline-js 弹出支付窗口。支付完成后必须在服务端调用验证接口,检查 status 为 success 且 amount 与预期一致再履约。保存的 authorization_code 在 reusable 为 true 时可复用扣款。
适用场景:一次性支付、订阅、保存卡扣款、计量计费、交易查询与对账导出。
限制与注意:交易 ID 为无符号 64 位整数,TypeScript 中应以字符串存储避免精度丢失;不可仅信任客户端回调;metadata 需先字符串化;部分扣款仅支持 NGN 或 GHS。具体费率、限额与平台支持范围资料未提供。