SuperAPI AI 工具集

interswitch-transfers

编程与开发

查看项目

更新于 10-16 07:59

技能介绍

用途:通过 Interswitch Transfers API 向银行账户和移动钱包发起资金转账,覆盖账户验证、单笔转账、批量转账与状态查询。

主要能力与端点:POST /api/v2/nameenquiry 验证银行账户;POST /api/v2/quickteller/payments/transfers 发起单笔转账;POST /api/v2/quickteller/payments/transfers/bulk 发起批量转账;GET /api/v2/quickteller/payments/transfers/{ref} 查询转账状态。

推荐流程:先用 name enquiry 验证目标账户,构建 sender 与 beneficiary 对象,生成 MAC 哈希后提交转账,最后查询状态确认完成。

MAC 生成:转账需 Message Authentication Code,对 amount、sendCurrency、receiveCurrency、paymentMethod、countryCode 按顺序拼接后做 SHA-512 哈希,输出 hex。示例中金额 500000 表示 ₦5,000,paymentMethod 为 'AC'(账户),countryCode 为 'NG'。

必要用法:请求头通过 getAuthHeaders() 获取并附加;接口地址基于环境变量 INTERSWITCH_BASE_URL;单笔转账请求包含 mac、beneficiary、sender、initiatingEntityCode、transferAmount{amount,currency}、paymentMethod、terminatingEntityCode、countryCode、transactionRef。

常见银行代码:Access 044、First 011、GTBank 058、UBA 033、Zenith 057、Stanbic IBTC 221、Fidelity 070、Sterling 232、Union 032、Wema 035。

最佳实践与限制:每次转账前先验证账户并向用户确认账户名;生成唯一 transactionRef 防止重复转账;不假设初始响应即成功,需查询状态;MAC 拼接逻辑不要在客户端暴露;批量操作应限流。金额单位、货币代码、商户码等需按资料填写,其他费用、限额与错误码暂未提供。