SuperAPI AI 工具集

flutterwave-beneficiaries

编程与开发

查看项目

更新于 11-05 16:16

技能介绍

用途

flutterwave-beneficiaries 用于在 Flutterwave 支付集成中维护可复用的转账收款人(recipients)与付款人(senders),以便更清晰地进行转账编排。

主要能力

  • 提供 TypeScript 实现样例,封装 Flutterwave v3 与 v4 的基础 URL、密钥读取与统一请求函数 flwRequest。
  • 定义 FlwResponse 响应类型与 FlutterwaveApiError 错误类,区分 API 错误与网络错误。
  • 列出受益人相关端点:v3 POST /beneficiaries 创建受益人;v4 GET /transfers/recipients 列出收款人、POST /transfers/recipients 创建收款人、DELETE /transfers/recipients/{id} 删除收款人、POST /transfers/senders 创建付款人。
  • 提供国家/通道矩阵:NG 银行受益人需先验证账户归属;KE/GH 移动钱包受益人需存储运营商与手机号元数据;所有市场均需分离付款人与收款人以满足合规审计。
  • 提供可靠性检查清单:履约前在服务端复核支付状态、存储提供方 ID/内部 ID/tx_ref/事件 ID 以便对账、Webhook 消费保持幂等并快速返回 HTTP 200、按版本分离请求/响应类型。

使用方式

通过环境变量配置 FLW_V3_BASE_URL、FLW_V4_BASE_URL 与 FLW_SECRET_KEY,调用 flwRequest 指定版本与路径发起请求。示例函数 runBeneficiariesExample 以 v4 GET /transfers/recipients 演示调用方式。

适用场景

适用于需要管理 Flutterwave 转账收款人、付款人及受益人信息的支付集成开发场景,尤其涉及尼日利亚银行账户、肯尼亚/加纳移动钱包等市场的转账编排。

限制

技能资料未提供完整的请求/响应字段定义、速率限制、价格或计费信息;v4 在公开参考中以资源为中心,需注意版本差异,避免 v3 与 v4 的 schema 混用。