用途:为 fintech 卡项目接入 Interswitch 的卡片处理能力,覆盖扣款、冲正、余额查询与资金留置(lien)管理。
主要能力(均为 POST): /api/v1/fintech/cards/debit 借记卡; /api/v1/fintech/cards/reversal 冲正借记; /api/v1/fintech/cards/enquiry 余额查询; /api/v1/fintech/cards/lien 建立留置; /api/v1/fintech/cards/lien/release 释放留置。
用法要点:调用时使用 getAuthHeaders() 生成鉴权头,并以 Content-Type: application/json 发送;请求经 ${process.env.INTERSWITCH_BASE_URL} 拼接端点。金额以 kobo 为单位,货币 NGN 用 '566'。请求中需提供 transactionRef、terminalId、merchantCode;卡号 pan 需加密。响应含 responseCode、responseDescription 等字段,成功码为 '00'。
建议流程:先余额查询确认可用余额,再按需建立留置、扣款,扣款成功后释放留置;失败则冲正。最佳实践:PAN 必须加密、引用唯一以避免重复扣款、留置即使失败也要释放、及时处理冲正、扣款前校验余额。
限制:资料未提供具体鉴权方式细节、错误码全集、限额、费率、接入门槛与测试环境说明,暂未提供。