用途 flutterwave-setup 是一个用于初始化 Flutterwave 客户端的集成技能,目标是让接入代码具备生产安全性:类型化请求、环境守卫(缺少密钥即报错)、以及按 API 版本区分的基础 URL。
主要能力 资料中的实现模式(TypeScript)包含:通过环境变量 FLW_V3_BASE_URL、FLW_V4_BASE_URL、FLW_SECRET_KEY 配置;v3 默认指向 https://api.flutterwave.com/v3,v4 默认指向 https://developersandbox-api.flutterwave.com;定义 FlwResponse<T> 响应类型(status 为 success 或 error,含 message 与 data);定义 FlutterwaveApiError 错误类,携带 HTTP 状态码与原始负载。flwRequest 函数负责:检查密钥是否存在、拼接版本对应基础 URL、注入 Content-Type 与 Bearer 授权头、解析 JSON 响应,并在 response.ok 为假或 status 为 error 时抛出错误。
使用方式 导入该技能后,可直接调用 flwRequest(如示例中的 runFlutterwaveSetupExample,以 GET 方式请求 v4 的 /charges)。资料给出的端点参考表包括:v3 的 GET /banks/{country}(查询银行)、GET /transactions/{id}/verify(验证交易),v4 的 GET /customers(列出客户)、GET /charges(列出收费)。可按需扩展路径与请求方法。
适用场景 适用于在 Node/TypeScript 项目中对接 Flutterwave 支付 API 的初始化阶段,尤其是需要同时兼容 v3 与 v4、希望统一错误处理与类型定义的集成。资料还给出地区/通道建议:NG 采用卡 + 银行转账,KE 采用 M-Pesa 优先加卡兜底,GH 采用 MTN/Vodafone 加卡并在结账时优先选择运营商。
可靠性清单与限制 资料强调:履约前在服务端重新验证支付成功状态;存储 provider id、内部 id、tx_ref 与事件 id 以便对账;webhook 消费者需幂等并快速返回 HTTP 200;按版本隔离请求/响应类型避免 schema 混淆。v4 在公开参考中以资源为中心,代码中应保留版本化路由映射与负载类型。资料未提供安装命令、依赖清单、完整端点覆盖、费率或价格信息,这些需以官方文档为准。