SuperAPI AI 工具集

flutterwave-bulk-virtual-accounts

编程与开发

查看项目

更新于 11-05 16:16

技能介绍

用途:该技能面向 Flutterwave 集成的批量专用虚拟账户场景,用于编排批量创建账户并将其分配给客户或业务对象的工作流。

主要能力:资料描述了统一的 API 请求封装(含基础地址选择、Bearer 鉴权、响应解析与 FlutterwaveApiError 错误类型),并列出可用的端点操作:v3 的 POST /bulk-virtual-account-numbers 用于批量创建专用账户;v4 的 POST /virtual-accounts 可用于循环或批处理方式创建账户;v4 的 GET /virtual-accounts 用于审计批量执行结果。

使用方式:通过环境变量 FLW_V3_BASE_URL、FLW_V4_BASE_URL、FLW_SECRET_KEY 配置访问参数;调用 flwRequest 并传入版本、路径与请求选项。资料给出的示例是对 v4 /virtual-accounts 发起 GET 请求。

适用场景:需要批量为用户开通专用账户的产品(例如发票或钱包类业务);资料提示 NG 市场常用于此类批量发放,KE/GH 等市场需先按能力开关判断再开通,并对每条记录跟踪成功/失败状态。

限制与注意事项:资料未提供完整的批量分配流程实现、并发或重试策略、速率限制与配额说明、具体国家支持范围细节,也未提供收费信息,这些内容暂未提供。可靠性方面建议在履约前于服务端复核支付状态,保存 provider id、内部 id、tx_ref 与事件 id 以便对账,Webhook 消费端保持幂等并快速返回 HTTP 200,同时按 API 版本区分请求与响应类型,避免 schema 混用。