SuperAPI AI 工具集

flutterwave-standard-checkout

编程与开发

查看项目

更新于 11-05 16:16

技能介绍

用途 该技能用于集成 Flutterwave 的托管式结账(Standard Checkout),并处理支付完成后的重定向与后端验证流程,确保只有服务端确认成功后才履行订单。

主要能力

  1. 版本化 API 请求封装:提供基于 TypeScript 的 flwRequest 函数,按版本切换基础地址(v3 默认 https://api.flutterwave.com/v3,v4 默认 https://developersandbox-api.flutterwave.com),并读取 FLW_V3_BASE_URL、FLW_V4_BASE_URL、FLW_SECRET_KEY 环境变量。
  2. 统一错误处理:定义 FlwResponse 响应类型与 FlutterwaveApiError 异常类,在响应非 2xx 或 status 为 error 时抛出错误。
  3. 端点操作参考: v3 POST /payments 用于初始化托管结账; v3 GET /transactions/{id}/verify 用于服务端验证; v4 POST /charges 用于创建 charge intent; v4 GET /charges/{id} 用于确认最终状态。
  4. 市场与支付通道参考:列出 NG(卡 + 银行转账)、KE(M-Pesa + 卡)、ZA(卡)的接入注意事项。
  5. 可靠性清单:服务端再次验证支付状态后再履约;存储 provider id、内部 id、tx_ref 与事件 id 以便对账;Webhook 消费需幂等并快速返回 HTTP 200;按版本分离请求与响应类型避免 schema 混用。

使用方式 在 TypeScript 项目中配置 FLW_SECRET_KEY 及可选的基础地址环境变量,调用 flwRequest 发起请求。资料中包含 runStandardCheckoutExample 示例,展示以 v4 的 /charges 路径发起 GET 请求的写法。注意请求头会自动附带 Content-Type: application/json 与 Bearer 密钥。

适用场景 需要接入 Flutterwave 托管收银台、并在服务端做支付确认与对账的支付集成项目,尤其适用于面向尼日利亚、肯尼亚、南非市场的应用。

限制 资料未提供完整的生产环境端点、Webhook 签名校验细节、具体费率或平台支持范围;v4 在公开参考中以资源为中心,需在代码中保持路由与载荷类型的版本化管理。示例中的 v4 地址为沙箱地址,生产使用时需按 Flutterwave 文档确认。