SuperAPI AI 工具集

paystack-refunds

编程与开发

查看项目

更新于 10-16 07:59

技能介绍

用途:该技能封装 Paystack Refunds API,用于对交易发起和管理退款,支持全额与部分退款。依赖 paystack-setup 提供 paystackRequest 辅助函数;相关技能为 paystack-webhooks,可监听 refund.processed、refund.failed、refund.pending 等事件。

主要能力与端点:POST /refund 创建退款;POST /refund/retry_with_customer_details/:id 用客户银行资料重试失败退款;GET /refund 列出退款;GET /refund/:id 查询单笔退款。

创建退款参数:transaction 必填,为交易参考号或 ID;amount 可选,以子单位表示,默认全额退款;currency、customer_note、merchant_note 可选。重试退款需传 refund_account_details 对象,包含必填的 currency(与原支付币种一致)、account_number、bank_id(来自 List Banks 端点)。列表支持按 transaction、currency、from、to 过滤,并可用 perPage(默认 50)与 page(默认 1)分页。

状态:pending、processing、processed、failed、needs-attention。失败退款会把金额退回你的 Paystack 余额;needs-attention 需用客户银行资料重试。

限制与注意:退款金额不能超过原交易金额;省略 amount 即全额退款;建议监听 webhook 事件而非轮询退款状态。未提供收费、价格与平台信息。