用途:该技能封装 Interswitch Payouts API,用于查询尼日利亚可用的付款渠道与收款机构,从而为付款路由提供依据。据资料,拿到机构代码后可配合 interswitch-transfers 技能发起实际转账。
主要能力与接口:GET /api/v1/payouts/channels 列出可用付款渠道;GET /api/v1/payouts/institutions 列出收款机构,可用 channel 参数过滤;GET /api/v1/payouts/institutions/{code} 获取指定机构详情。渠道对象包含 channelCode、channelName、description、supportedCurrencies、isActive。机构对象包含 institutionCode、institutionName、type(BANK、MICROFINANCE、MOBILE_MONEY)、isActive、supportedChannels、nipCode。资料列出的渠道有 BANK(银行转账)、MOBILE_MONEY(移动钱包)、CARD(卡支付)、PAYCODE(ATM 无卡取款)。
使用方式:调用前需准备鉴权头(资料以 getAuthHeaders() 表示)和 INTERSWITCH_BASE_URL 环境变量。路由逻辑为:先查机构详情,再取渠道列表并过滤出该机构支持且处于启用状态的渠道;若无可用渠道则报错;否则优先选择 BANK,找不到再回退到第一个可用渠道。
适用场景:需要在付款前确认机构代码有效性、查看机构支持的渠道,或根据机构能力选择付款通道。
限制与注意事项:资料未提供各接口的鉴权细节、配额、费率、错误码及环境地址,均暂未提供。建议做法包括:缓存机构列表(如每日刷新)、只路由到 isActive 为真的机构、准备备用渠道、发起转账前校验机构代码、监控渠道可用性。实际发起付款不在本技能范围内。