用途
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;v4GET /payment-methods列出可复用支付方式;v4POST /charges对存储支付方式发起扣款;v4GET /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 注册步骤等细节,暂未提供。