SuperAPI AI 工具集

flutterwave-bank-transfers

编程与开发

查看项目

更新于 11-05 16:16

技能介绍

用途:本技能面向需要集成 Flutterwave 银行转账收款的场景。开发者可以通过它发起银行转账收款,并在服务端异步确认最终支付结果,避免仅依赖前端或回调即发货。

主要能力:

  1. 统一请求封装:提供 flwRequest 函数,按版本选择 v3 或 v4 基础地址,自动附带 Authorization 与 Content-Type 头,并将非成功响应统一抛出 FlutterwaveApiError,便于错误处理。
  2. 环境变量配置:使用 FLW_V3_BASE_URL、FLW_V4_BASE_URL、FLW_SECRET_KEY 进行配置,其中密钥缺失时会直接报错。
  3. 端点覆盖:v3 支持 POST /charges?type=bank_transfer 发起银行转账收款,GET /banks/{country} 查询支持银行;v4 支持 POST /bank-account-resolve 校验账户信息,GET /banks 获取银行列表。
  4. 国家通道参考:尼日利亚使用 NIP 转账流程;加纳采用银行转账并以移动钱包作为兜底;肯尼亚提供银行转账结合 M-Pesa 的移动优先兜底。

使用方式:在 TypeScript 项目中引入上述类型与函数,配置环境变量后调用 flwRequest,指定版本、路径与请求方法即可;示例为调用 v4 的 /banks 获取银行列表。

适用场景:适合需要在后端集成银行转账收款、账户校验、银行列表查询,并按国家选择对应支付通道的支付系统开发。

限制与注意事项:资料仅提供接口路径与参考链接,未给出完整业务参数、字段说明与错误码;需在服务端再次核验支付状态后再履约,保存 provider id、内部 id、tx_ref 与事件 id 以便对账,并保持 webhook 消费幂等与快速返回 HTTP 200;v3 与 v4 的请求与响应类型应分开定义,避免 schema 混淆。具体收费、平台限制与完整使用步骤暂未提供。