用途:接入 Interswitch 增值服务(VAS)API,通过 Quickteller Business 平台实现账单缴费、话费/流量充值、客户信息校验与电子 PIN 相关交易。
主要能力(接口):
- GET /api/v2/quickteller/categorys 列出账单分类
- GET /api/v2/quickteller/categorys/{id}/billers 获取分类下商户
- GET /api/v2/quickteller/billers/{id}/paymentitems 获取缴费项目
- POST /api/v2/quickteller/customers/validations 校验客户
- POST /api/v2/quickteller/payments/advices 发送缴费
- POST /api/v2/quickteller/payments/recharges 话费/流量充值
典型流程:先取分类,再取分类下商户,再取缴费项目;用缴费项目的 paymentCode 与客户账号/表号调用校验接口,responseCode 为 00 表示通过;随后调用缴费或充值接口,金额以 kobo 为单位,需提供唯一 requestReference,响应中可能返回 rechargePIN(Token/PIN)。
常见商户分类包括公用事业(PHCN 电费、水务)、有线电视(DSTV、GOTV、StarTimes)、互联网(Spectranet、Smile、Swift)、话费(MTN、Airtel、Glo、9mobile)、教育(WAEC、JAMB)、保险与政府税费等。
使用方式:文档示例使用环境变量 INTERSWITCH_BASE_URL 与 getAuthHeaders(),通过 fetch 调用各接口;需为 POST 请求添加 Content-Type: application/json。
最佳实践与限制:付款前始终校验客户;检查商户支持的付款类型;区分固定金额与可变金额;保存 requestReference 以便查询与对账;付款前展示客户姓名供确认。金额单位为 kobo。文档未提供鉴权头获取方式、费率、限额或错误码的具体说明,暂未提供。