SuperAPI AI 工具集

interswitch-wallets

办公与效率

查看项目

更新于 10-16 07:59

技能介绍

用途:通过 Interswitch Wallet Services API 为商户和消费者创建与管理虚拟钱包,钱包包含虚拟卡信息(PAN、CVV、有效期),便于卡片类交易、在线支付和钱包内购买。

主要能力:

  • 创建钱包:POST /api/v1/wallet,请求体含 firstName、lastName、email、phoneNumber(尼日利亚格式 +234XXXXXXXXXX)、pin(4 位数字)、可选 dateOfBirth(YYYY-MM-DD)与 bvn(11 位银行验证号)。返回 walletId、pan、expiry(YYMM)、cvv、virtualCard、accountNumber、bankCode、status。
  • 查询钱包详情:GET /api/v1/wallet/{walletId}。
  • 查询余额:GET /api/v1/wallet/{walletId}/balance,返回 availableBalance、ledgerBalance、currency。

使用方式:需先配置环境变量 INTERSWITCH_WALLET_BASE_URL,测试为 https://qa.interswitchng.com,正式为 https://saturn.interswitchng.com;请求需携带鉴权头(getAuthHeaders)。示例代码展示了 createWallet、getWalletDetails、getWalletBalance 三个函数。资料还给出 zod 输入校验规则,如电话须匹配 /^+234[0-9]{10}$/、pin 须为 4 位数字、bvn 须为 11 位数字等。

适用场景:面向尼日利亚市场的虚拟钱包与虚拟卡创建、余额查询、钱包购买等。

限制与安全注意:PAN/CVV 不应暴露给客户端代码;应存储 walletId 而非卡详情;PIN 不得明文记录或存储;BVN 属个人敏感信息,应加密存储。资料未提供具体收费、价格、平台支持范围等信息。