SuperAPI AI 工具集

interswitch-card360

编程与开发

查看项目

更新于 10-16 09:50

技能介绍

用途:该技能封装 Interswitch Card 360 API,用于管理借记卡的完整生命周期,包括发卡、PIN 管理、冻结/解冻和余额查询。资源将卡片生命周期描述为:创建卡 → 设置 PIN → 激活 → 使用 → 冻结/解冻 → 过期/续期。

主要能力(端点):POST /api/v1/cards 创建/发行卡片;GET /api/v1/cards/{cardId} 获取卡详情;GET /api/v1/cards/{cardId}/balance 查询卡余额;PUT /api/v1/cards/{cardId}/pin 设置或重置 PIN;POST /api/v1/cards/{cardId}/block 冻结卡;POST /api/v1/cards/{cardId}/unblock 解冻卡;GET /api/v1/cards/{cardId}/status 获取卡状态。

使用方式:通过环境变量 INTERSWITCH_BASE_URL 拼接基础地址,配合 getAuthHeaders() 提供的请求头调用接口。创建卡需提供 customerId、cardType(VIRTUAL 或 PHYSICAL)、cardScheme(VERVE、VISA 或 MASTERCARD)、currency(如 NGN)、accountNumber、bankCode、firstName、lastName、phoneNumber、email、dateOfBirth(YYYY-MM-DD),address 可选。卡响应含 responseCode、cardId、掩码 PAN、expiryDate(YYMM)、cardType、cardScheme、status、createdAt。设置 PIN 时初始设置只需 newPin 与 confirmPin(4 位数字),修改 PIN 需额外提供 oldPin。冻结卡需 reason 与 blockType(TEMPORARY 或 PERMANENT)。解冻只需 cardId。

卡状态包括 ACTIVE(可用)、INACTIVE(已创建未激活)、BLOCKED(临时冻结)、EXPIRED(已过期)、CLOSED(永久停用)。余额返回 availableBalance、ledgerBalance、currency。

限制与最佳实践:不得记录完整 PAN,仅使用掩码版本;不得存储或记录 PIN;怀疑欺诈时立即冻结;设置 PIN 重试上限(如 3 次失败后锁定);线上场景优先使用虚拟卡;监控卡状态变化。资料未提供认证获取细节、收费、价格与速率限制等信息。