用途:该技能围绕 Interswitch Cardless Payments API,实现无卡 ATM 取现流程——客户提出取款金额,系统生成 paycode,客户通过短信或应用收到取款码,在支持 Interswitch 的 ATM 输入该码即可取现。
主要能力:提供生成单个 paycode、生成批量 paycode、查询 paycode 状态、取消 paycode 四类接口。请求字段包括 amount(单位 kobo)、senderName、senderPhone(+234 格式)、beneficiaryPhone、beneficiaryName、transactionRef,可选 currency(默认 NGN)与 expiryMinutes。响应返回 responseCode、responseDescription、paycode、transactionRef、amount、expiryDate;批量接口额外返回 batchRef、paycodes、successCount、failureCount。
使用方式:接口路径为 POST /api/v1/paycode、POST /api/v1/paycode/bulk、GET /api/v1/paycode/{code}、DELETE /api/v1/paycode/{code},通过 getAuthHeaders() 获取认证头,并以环境变量 INTERSWITCH_BASE_URL 作为基础地址发起请求。生成后需自行通过短信或通知系统把 paycode 发给受益人,并可定期用状态接口核对(responseCode 为 '00' 表示已使用),必要时取消。
适用场景:企业向无银行账户员工发放薪资、紧急现金转账、代理银行现金分发、促销现金奖励等。
限制:资料未提供具体认证方式、费率、限额、支持的 ATM 网络范围及错误码完整清单;金额以 kobo 为单位,手机号需按 +234 格式传入,生产使用前应确认官方文档与实际可用性。