SuperAPI AI 工具集

paystack-disputes

办公与效率

查看项目

更新于 10-16 03:04

技能介绍

用途:管理 Paystack 集成中的交易争议与拒付。依赖 paystack-setup 提供的 paystackRequest 辅助函数。

主要端点:GET /dispute 列出争议;GET /dispute/:id 获取单个争议;GET /dispute/transaction/:id 列出某交易的争议(返回 history 与 messages);PUT /dispute/:id 更新争议;POST /dispute/:id/evidence 添加证据;GET /dispute/:id/upload_url 获取附件上传地址;PUT /dispute/:id/resolve 解决争议;GET /dispute/export 导出争议。

争议状态包括 awaiting-merchant-feedback(等待商户响应)、awaiting-bank-feedback(银行审核证据)、pending(处理中)、resolved(已解决)。

用法:通过 paystackRequest 调用上述端点。列表示例:await paystackRequest("/dispute?from=2024-01-01&to=2024-12-31&status=awaiting-merchant-feedback"); 更新时可传 refund_amount(以最小货币单位计)与 uploaded_filename。添加证据可提交 customer_email、customer_name、customer_phone、service_details、delivery_address、delivery_date 等字段。获取上传地址后用 PUT 将文件传到返回的签名 URL,再用返回的 fileName 在更新或解决时引用。解决时传 resolution(如 merchant-accepted 或 declined)、message、refund_amount、uploaded_filename,欺诈类可附 evidence 证据 ID。导出返回 CSV 下载地址。

限制:资料未说明权限范围、速率限制、具体错误码及非上述字段的约束,这些暂未提供。