interswitch-card-payments

用途：通过 Interswitch API 直接处理银行卡支付，覆盖卡号、有效期、CVV、PIN 的采集与加密，并支持 3D Secure、Hosted Fields 和 Google Pay。资料提供测试凭据（Client ID、Secret Key、Merchant Code、Pay Item ID）与卡数据加密方法：将 PAN、PIN、有效期、CVV 拼接后用 Interswitch 模数/指数加密生成 authData，再随支付请求发送。支付接口为 POST {collectionsBaseUrl}/collections/api/v1/pay，金额以最小货币单位表示，NGN 币种代码为 566；响应含 responseCode、paymentId、transactionRef 等字段。若返回 T0 表示需 OTP，调用 /collections/api/v1/pay/validate 提交 paymentId、transactionRef、otp；3DS 流程则返回 Z9 或 S0 及 redirectUrl、transactionId、md，跳转银行页面后回调完成交易，再以 eciFlag 调 validate 接口完成。Hosted Fields 通过引入 https://newwebpay.qa.interswitchng.com/hosted-fields.js，用 iframe 收集卡数据，配置 merchantCode、payItemId、transactionRef、amount、currency、mode 与各字段选择器，提交后进入 onComplete 回调。Google Pay 需检查可用性，配置 tokenizationSpecification，网关为 interswitch，再请求 paymentData 并将令牌发送至服务器处理。安全建议：不记录原始卡数据，仅处理加密 authData；尽量使用 Hosted Fields 满足 PCI；服务端复核每笔交易；按响应码实现 OTP、3DS 等错误流程；使用唯一交易参考号避免重复扣款。限制：资料未提供正式环境地址、完整模数与指数、费率、价格或平台支持范围，部分代码占位需从官方文档补齐；资料也未说明具体可用国家与卡组织范围，使用前应核对官方最新信息。