SuperAPI AI 工具集

flutterwave-tokenized-charges

编程与开发

查看项目

更新于 11-05 16:16

技能介绍

用途

flutterwave-tokenized-charges 是 devmubarak1/flutterwave 技能集合中的一个技能,其目的为:对已保存的支付方式执行周期性扣款,并提供显式的重试控制。

主要能力

  • 通过环境变量 FLW_V3_BASE_URL、FLW_V4_BASE_URL、FLW_SECRET_KEY 配置 Flutterwave v3 与 v4 接口(默认地址分别为 https://api.flutterwave.com/v3 与 https://developersandbox-api.flutterwave.com)。
  • 提供 TypeScript 的 flwRequest 封装,按要求附加 Authorization: Bearer 与 Content-Type: application/json 头,并将返回体解析为 FlwResponse。
  • 定义 FlutterwaveApiError,携带状态码与响应负载,用于统一处理接口错误。
  • 涉及的接口操作包括:v3 POST /tokenized-charges 创建 tokenized charge;v4 GET /payment-methods 列出可复用支付方式;v4 POST /charges 对存储支付方式发起扣款;v4 GET /charges/{id} 校验结果状态。

使用方式

资料给出统一请求函数与示例函数 runTokenizedChargesExample,示意以 v4 调用 /charges。需要设置 FLW_SECRET_KEY 环境变量,否则请求函数会抛出缺少密钥的错误。v4 在公开参考中以资源为中心,资料建议在代码中保持路由映射与载荷类型的版本区分。

适用场景与市场说明

资料列出市场与通道矩阵:尼日利亚(NG)以卡 token 周期性扣款为主流;肯尼亚/加纳(KE/GH)在 token 扣款失败时以移动货币(MoMo)周期性扣款作为回退;所有市场可采用按国家区分的重试与催款(dunning)策略。

可靠性要点

资料建议:履约前在服务端再次确认支付成功状态;保存服务商 ID、内部 ID、tx_ref 与事件 ID 以便对账;保证 webhook 消费方幂等并快速返回 HTTP 200;将不同版本的请求/响应类型分开定义,避免 schema 混淆。

限制

资料未提供支持的支付方式完整列表、费率、限流、具体重试次数与退避策略、Webhook 注册步骤等细节,暂未提供。