SuperAPI AI 工具集

paystack-setup

通用与其它

查看项目

更新于 10-16 01:28

技能介绍

用途:为服务端 TypeScript/JavaScript 应用搭建 Paystack 支付集成的基础设施,包括 API 客户端、环境变量与类型辅助函数。

主要能力:提供 Paystack API 基础约定(Base URL https://api.paystack.co、认证头 Authorization: Bearer SECRET_KEY、Content-Type application/json、响应格式 { status, message, data });说明金额以货币最小单位传递(显示金额 ×100),交易 ID 为无符号 64 位整数、在 TypeScript 中应用字符串表示;列出 NGN、USD、GHS、ZAR、KES、XOF、EGP、RWF 等币种及其子单位。

使用方式:在 .env 或 .env.local 中配置 PAYSTACK_SECRET_KEY(服务端专用)与 NEXT_PUBLIC_PAYSTACK_PUBLIC_KEY(前端可用);客户端弹窗/内联结账安装依赖 npm install @paystack/inline-js(或 pnpm add / yarn add),服务端无需 SDK,使用内置 fetch 配合封装好的 paystackRequest 辅助函数即可。列表接口支持 perPage(默认 50、最大 100)与 page 参数,返回 meta 分页信息。金额换算建议用 Math.round(amount * 100) 避免浮点误差。

适用场景:新建服务端支付集成、统一调用封装、分页查询与错误处理。

限制:密钥 sk_* 绝不可暴露于客户端或公开仓库;所有 API 调用须在服务端执行;回调与 webhook 使用 HTTPS;金额需服务端校验;支付后必须服务端核验交易状态。错误处理可捕获 PaystackError 并按 400/401/404 等状态码分支处理。具体收费与价格资料暂未提供。