SuperAPI AI 工具集

interswitch-split-settlement

编程与开发

查看项目

更新于 10-16 07:59

技能介绍

用途:该技能封装 Interswitch Split Settlement API,用于在一次钱包支付中把金额按比例分配到多个受益账户(银行账户或钱包),适用于平台分润、市场抽成、代收代缴等场景。

主要能力:初始化分账支付(POST /api/v2/wallet-pay/initialize),提交后按 splitSettlement 列表分配金额;查询分账支付状态(POST /api/v2/wallet-pay/status),用 transactionRef 与 amount 校验结果;获取可用的结算账户列表(GET /api/v1/settlement/accounts)。金额单位为 kobo,货币 NGN 用 '566'。

使用方式:鉴权使用 Passport v2,base URL 取环境变量 INTERSWITCH_SPLIT_PASSPORT_URL,测试环境 https://qa.interswitchng.com,生产环境 https://saturn.interswitchng.com。每个分账项需提供 accountId、accountType('BANK' 或 'WALLET')、percentage、splitPercentage;accountType 为 'BANK' 时还需 bankCode 与 accountNumber。可用配置对象(SplitConfig)统一维护固定分账方,并在构造时校验比例合计为 100,否则抛错。示例:70% 给供应商、20% 给平台、10% 给物流。

适用场景:市场平台向商家、平台、物流等多方分账;州/地方政府代征费用按比例分配等。

限制与注意:比例合计必须为 100%;必须使用 Collections Passport v2 鉴权;配置前应核对受益账户的有效性;提交后应调用状态接口确认结算结果;部分受益方可能失败而其他成功,需要处理部分失败。资料未提供费率、限额、重试策略与具体错误码明细。