--- updatedAt: 2026-04-28T11:47:20.000Z agentTools: projectIndex: https://docs.interswitchgroup.com/llms.txt --- # Get Wallet Cards This API helps to retrieve the list of all the cards that your customers have saved on `quickteller.com` # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "accept-payment-1", "version": "1.0" }, "servers": [ { "url": "https://sandbox.interswitchng.com" } ], "security": [ {} ], "paths": { "/collections/api/v1/sdk/wallets": { "post": { "summary": "Get Wallet Cards", "description": "This API helps to retrieve the list of all the cards that your customers have saved on `quickteller.com`", "operationId": "get-wallet-cards", "parameters": [ { "name": "Content-Type", "in": "header", "required": true, "schema": { "type": "string", "default": "application/json" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string", "default": "Bearer eyJhbGciOiJSUzI1NiJ9.eyJhdWQiOlsiaXN3LWNvbGxlY3Rpb25zIiwiaXN3LXBheW1lbnRnYXRld2F5IiwicGFzc3BvcnQiLCJwcm9qZWN0LXgtbWVyY2hhbnQiLCJ2YXVsdCJdLCJtZXJjaGFudF9jb2RlIjoiTVg2MDcyIiwicmVxdWVzdG9yX2lkIjoiMTIzODA4NTk1MDMiLCJzY29wZSI6WyJwcm9maWxlIl0sImp0aSI6ImI2MjE1YjhlLTE0MzQtNGVjMC1hN2QwLWU3ZDRjYWNlM2Y3NyIsInBheWFibGVfaWQiOiIzMzU5NyIsImNsaWVudF9pZCI6IklLSUFCMjNBNEUyNzU2NjA1QzFBQkMzM0NFM0MyODdFMjcyNjdGNjYwRDYxIn0.RFZ5W1cJUo6iR6rorXGuackdISc4Tb7rCPeah6JOP948sEri2iVezeiBMFK276uym0GCDDuM6FFwxonsfmlOL5l7Grjs7TSE5OYf4tVKdamtTb61NzQGjBzfNVhjxSHH6rDlWvZe9JNEjiiBcnIaBXgoeb4LSG66ezasyHVzW7UYAHA8SbUX6GolrJKPb8VYiXAPy1TNN_5FwLQNPmCnl91UoE_odYWb0-oC-ScmMFm_iZUWt7Y7ZJwGJJrxijUA3p0PX8g4ME-pkIl7Kyp3JOtLTUUM-f-VXk2uVqmnSgdU68fOpt7Ji69jV8CEq9e_1xiIV__dxm3-KgznbSCzJA" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "username", "password" ], "properties": { "username": { "type": "string", "default": "bughunting005@gmail.com" }, "password": { "type": "string", "default": "password" } } } } } }, "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"paymentMethods\": [\n {\n \"cardTypeCode\": \"VVC\",\n \"cardTypeName\": \"VERVE\",\n \"maskedPan\": \"506099*********5521\",\n \"accountNumber\": \"\",\n \"cardIdentifier\": \"03D9535A42C0A484452A4C2A8CBC04FD4019B65949A83CC14\",\n \"cardHash\": \"112C45C4D3C9955A401006C1462F4369\",\n \"walletInstrumentIdentifier\": \"6820DEB3360E4EE893267E2E7EB5AEE4\",\n \"status\": \"Active\",\n \"expiryMonth\": \"04\",\n \"expiryYear\": \"50\",\n \"issuer\": {\n \"id\": 101,\n \"name\": \"FIRST BANK OF NIGERIA\",\n \"code\": \"FBN\",\n \"domainTypeId\": 1,\n \"countryCode\": \"NG\",\n \"cbnCode\": \"011\"\n },\n \"name\": \"FirstBank Master Card\",\n \"cookieKey\": \"62CC6E8B48FABEA08D56790F379049C788999AB2\",\n \"loyaltyRedemptionAllowed\": false,\n \"maskToken\": true,\n \"enableFingerPrint\": false,\n \"cardTypeGatewayConfiguration\": {\n \"id\": 1,\n \"supportsPin\": true,\n \"supportsCvv2\": true,\n \"supportsExpiryDate\": true,\n \"enabled\": true,\n \"cardTypeCode\": \"VVC\",\n \"supportsOtp\": true,\n \"supportsCardinalAuthentication\": false,\n \"loyaltyRedeemEnabled\": true,\n \"loyaltyEnabled\": true,\n \"supportsFingerPrintAuthorization\": true,\n \"supportsAccountType\": true,\n \"supportsVisaAcceleratedConnectionPlatform\": false,\n \"supportsCybersource20\": false,\n \"cybersourceEnabled\": false\n }\n },\n {\n \"cardTypeCode\": \"VVC\",\n \"cardTypeName\": \"VERVE\",\n \"maskedPan\": \"506099*********7499\",\n \"accountNumber\": \"\",\n \"cardIdentifier\": \"03D9535A42C0A48441DD421235A327377E78C481B80BCC660\",\n \"cardHash\": \"6E64809B5795A1D86CB9188A6C3E73AF\",\n \"walletInstrumentIdentifier\": \"F88FFDF85C5D4DBF975E16264E11D5F5\",\n \"status\": \"limited\",\n \"expiryMonth\": \"03\",\n \"expiryYear\": \"50\",\n \"issuer\": {\n \"id\": 101,\n \"name\": \"FIRST BANK OF NIGERIA\",\n \"code\": \"FBN\",\n \"domainTypeId\": 1,\n \"countryCode\": \"NG\",\n \"cbnCode\": \"011\"\n },\n \"name\": \"FirstBank Verve Card\",\n \"cookieKey\": \"239A103C363FE134BE7D5BEECCB27BA100C779A0\",\n \"loyaltyRedemptionAllowed\": false,\n \"maskToken\": true,\n \"enableFingerPrint\": false,\n \"cardTypeGatewayConfiguration\": {\n \"id\": 1,\n \"supportsPin\": true,\n \"supportsCvv2\": true,\n \"supportsExpiryDate\": true,\n \"enabled\": true,\n \"cardTypeCode\": \"VVC\",\n \"supportsOtp\": true,\n \"supportsCardinalAuthentication\": false,\n \"loyaltyRedeemEnabled\": true,\n \"loyaltyEnabled\": true,\n \"supportsFingerPrintAuthorization\": true,\n \"supportsAccountType\": true,\n \"supportsVisaAcceleratedConnectionPlatform\": false,\n \"supportsCybersource20\": false,\n \"cybersourceEnabled\": false\n }\n },\n {\n \"cardTypeCode\": \"VCI\",\n \"cardTypeName\": \"VISA INTERNATIONAL\",\n \"maskedPan\": \"468219******0089\",\n \"accountNumber\": \"\",\n \"cardIdentifier\": \"0FC159C48D4ECBCA5BBC197E6710DE26310BC1594DC0008E1\",\n \"cardHash\": \"8DDB77CF9F8AA1528C0B3F6D2377AEA4\",\n \"walletInstrumentIdentifier\": \"ED11ACBE7232405EA4294178DCA2C7B7\",\n \"status\": \"limited\",\n \"expiryMonth\": \"05\",\n \"expiryYear\": \"23\",\n \"issuer\": {\n \"id\": 109,\n \"name\": \"FIDELITY BANK\",\n \"code\": \"FBP\",\n \"domainTypeId\": 1,\n \"countryCode\": \"NG\",\n \"cbnCode\": \"070\"\n },\n \"name\": \"FirstBank Visa Card\",\n \"cookieKey\": \"938B0A5DB461A3DA569A9C0E408A34D630C33D26\",\n \"loyaltyRedemptionAllowed\": false,\n \"maskToken\": false,\n \"enableFingerPrint\": false,\n \"cardTypeGatewayConfiguration\": {\n \"id\": 7,\n \"supportsPin\": true,\n \"supportsCvv2\": true,\n \"supportsExpiryDate\": true,\n \"enabled\": true,\n \"cardTypeCode\": \"VCI\",\n \"supportsOtp\": false,\n \"supportsCardinalAuthentication\": false,\n \"loyaltyRedeemEnabled\": false,\n \"loyaltyEnabled\": false,\n \"supportsFingerPrintAuthorization\": true,\n \"supportsAccountType\": false,\n \"supportsVisaAcceleratedConnectionPlatform\": false,\n \"supportsCybersource20\": true,\n \"cybersourceEnabled\": true,\n \"cybersourceCardId\": \"001\"\n }\n },\n {\n \"cardTypeCode\": \"VVC\",\n \"cardTypeName\": \"VERVE\",\n \"maskedPan\": \"506099*********0473\",\n \"accountNumber\": \"506************0473\",\n \"cardIdentifier\": \"03D9535A42C0A48446C857D8F3B13F6CF5847EC0C8E4A6C36\",\n \"cardHash\": \"8673827FF9FAD91E8FAC5FDAB88198E0\",\n \"walletInstrumentIdentifier\": \"713993DA61944C9A8CCBD15169798BF7\",\n \"status\": \"Active\",\n \"expiryMonth\": \"09\",\n \"expiryYear\": \"50\",\n \"issuer\": {\n \"id\": 101,\n \"name\": \"FIRST BANK OF NIGERIA\",\n \"code\": \"FBN\",\n \"domainTypeId\": 1,\n \"countryCode\": \"NG\",\n \"cbnCode\": \"011\"\n },\n \"name\": \"FirstBank eCash\",\n \"cookieKey\": \"770F43922BB04C88BE4DCBB77DFADCEC9E894C65\",\n \"loyaltyRedemptionAllowed\": false,\n \"maskToken\": true,\n \"enableFingerPrint\": false,\n \"cardTypeGatewayConfiguration\": {\n \"id\": 1,\n \"supportsPin\": true,\n \"supportsCvv2\": true,\n \"supportsExpiryDate\": true,\n \"enabled\": true,\n \"cardTypeCode\": \"VVC\",\n \"supportsOtp\": true,\n \"supportsCardinalAuthentication\": false,\n \"loyaltyRedeemEnabled\": true,\n \"loyaltyEnabled\": true,\n \"supportsFingerPrintAuthorization\": true,\n \"supportsAccountType\": true,\n \"supportsVisaAcceleratedConnectionPlatform\": false,\n \"supportsCybersource20\": false,\n \"cybersourceEnabled\": false\n }\n },\n {\n \"cardTypeCode\": \"VCC\",\n \"cardTypeName\": \"VISA\",\n \"maskedPan\": \"400000******1091\",\n \"accountNumber\": \"\",\n \"cardIdentifier\": \"0B70D3B0AE21A12B5E5AFBAB83A24DB2310BC1594DC0008E1\",\n \"cardHash\": \"6205C0ED8F22FF4A1F0526CB33622CF5\",\n \"walletInstrumentIdentifier\": \"62CEAC53AA8E4362AF7B81C66E675CB0\",\n \"status\": \"limited\",\n \"expiryMonth\": \"01\",\n \"expiryYear\": \"24\",\n \"issuer\": {\n \"id\": 103,\n \"name\": \"GUARANTY TRUST BANK\",\n \"code\": \"GTB\",\n \"domainTypeId\": 1,\n \"countryCode\": \"NG\",\n \"cbnCode\": \"058\"\n },\n \"name\": \"Guaranty Trust Bank Visa Card\",\n \"cookieKey\": \"61871746EB1EF53A1AAEE5256CC8653CCB3CE1A0\",\n \"loyaltyRedemptionAllowed\": false,\n \"maskToken\": false,\n \"enableFingerPrint\": false,\n \"cardTypeGatewayConfiguration\": {\n \"id\": 3,\n \"supportsPin\": false,\n \"supportsCvv2\": true,\n \"supportsExpiryDate\": true,\n \"enabled\": true,\n \"cardTypeCode\": \"VCC\",\n \"supportsOtp\": true,\n \"supportsCardinalAuthentication\": true,\n \"loyaltyRedeemEnabled\": false,\n \"loyaltyEnabled\": false,\n \"supportsFingerPrintAuthorization\": false,\n \"supportsAccountType\": true,\n \"supportsVisaAcceleratedConnectionPlatform\": false,\n \"supportsCybersource20\": true,\n \"cybersourceEnabled\": true,\n \"cybersourceCardId\": \"001\"\n }\n },\n {\n \"cardTypeCode\": \"VMP\",\n \"cardTypeName\": \"VERVE mPIN\",\n \"maskedPan\": \"528151*********0639\",\n \"accountNumber\": \"212***3049\",\n \"cardIdentifier\": \"0CE8CC6CF5A466474DC31F5136E8D4A53ADB774FC4050699F\",\n \"cardHash\": \"F2E05A9778D88D8BDE3C46229E0FC675\",\n \"walletInstrumentIdentifier\": \"EF6AC02F5B0249C08564AA1446410900\",\n \"status\": \"Active\",\n \"expiryMonth\": \"09\",\n \"expiryYear\": \"50\",\n \"issuer\": {\n \"id\": 103,\n \"name\": \"GUARANTY TRUST BANK\",\n \"code\": \"GTB\",\n \"domainTypeId\": 1,\n \"countryCode\": \"NG\",\n \"cbnCode\": \"058\"\n },\n \"name\": \"Guaranty Trust Bank eCash\",\n \"cookieKey\": \"E2AEF69579CE10EEBF4C2F24F87958EB9359C6BA\",\n \"loyaltyRedemptionAllowed\": false,\n \"maskToken\": false,\n \"enableFingerPrint\": false,\n \"cardTypeGatewayConfiguration\": {\n \"id\": 8,\n \"supportsPin\": true,\n \"supportsCvv2\": false,\n \"supportsExpiryDate\": false,\n \"enabled\": true,\n \"cardTypeCode\": \"VMP\",\n \"supportsOtp\": false,\n \"supportsCardinalAuthentication\": false,\n \"loyaltyRedeemEnabled\": false,\n \"loyaltyEnabled\": true,\n \"supportsFingerPrintAuthorization\": true,\n \"supportsAccountType\": false,\n \"supportsVisaAcceleratedConnectionPlatform\": false,\n \"supportsCybersource20\": false,\n \"cybersourceEnabled\": false\n }\n },\n {\n \"cardTypeCode\": \"VMP\",\n \"cardTypeName\": \"VERVE mPIN\",\n \"maskedPan\": \"628051*********0225\",\n \"accountNumber\": \"012***1122\",\n \"cardIdentifier\": \"0784B09919973D3AFDC31F5136E8D4A53E0BFCEDF0C506A24\",\n \"cardHash\": \"141A818A8252CA8819AC0B354A63BF7A\",\n \"walletInstrumentIdentifier\": \"13ECE816F23B49E7A71D5DF4191FD1E4\",\n \"status\": \"Active\",\n \"expiryMonth\": \"09\",\n \"expiryYear\": \"50\",\n \"issuer\": {\n \"id\": 107,\n \"name\": \"ACCESS BANK PLC\",\n \"code\": \"ABP\",\n \"domainTypeId\": 1,\n \"countryCode\": \"NG\",\n \"cbnCode\": \"044\"\n },\n \"name\": \"Union eCash\",\n \"cookieKey\": \"ECFAA4FFE3C908F8C4474C9DD7BE4EA8EEC07210\",\n \"loyaltyRedemptionAllowed\": false,\n \"maskToken\": false,\n \"enableFingerPrint\": false,\n \"cardTypeGatewayConfiguration\": {\n \"id\": 8,\n \"supportsPin\": true,\n \"supportsCvv2\": false,\n \"supportsExpiryDate\": false,\n \"enabled\": true,\n \"cardTypeCode\": \"VMP\",\n \"supportsOtp\": false,\n \"supportsCardinalAuthentication\": false,\n \"loyaltyRedeemEnabled\": false,\n \"loyaltyEnabled\": true,\n \"supportsFingerPrintAuthorization\": true,\n \"supportsAccountType\": false,\n \"supportsVisaAcceleratedConnectionPlatform\": false,\n \"supportsCybersource20\": false,\n \"cybersourceEnabled\": false\n }\n },\n {\n \"cardTypeCode\": \"VVC\",\n \"cardTypeName\": \"VERVE\",\n \"maskedPan\": \"628051*********1237\",\n \"accountNumber\": \"\",\n \"cardIdentifier\": \"0784B09919973D3AF8B7BA0B3CFDC968ACB58CB71115B1336\",\n \"cardHash\": \"A0AF896FFF73A06BF1EC08D421C14139\",\n \"walletInstrumentIdentifier\": \"91B0F4FAF2EF46639DE38EE2F5B21680\",\n \"status\": \"Active\",\n \"issuer\": {\n \"id\": 101,\n \"name\": \"FIRST BANK OF NIGERIA\",\n \"code\": \"FBN\",\n \"domainTypeId\": 1,\n \"countryCode\": \"NG\",\n \"cbnCode\": \"011\"\n },\n \"name\": \"Fidelity eCash\",\n \"cookieKey\": \"685926EB91F527B8FFE8DDB61A1556D5BE9953F0\",\n \"loyaltyRedemptionAllowed\": false,\n \"maskToken\": false,\n \"enableFingerPrint\": false,\n \"cardTypeGatewayConfiguration\": {\n \"id\": 1,\n \"supportsPin\": true,\n \"supportsCvv2\": true,\n \"supportsExpiryDate\": true,\n \"enabled\": true,\n \"cardTypeCode\": \"VVC\",\n \"supportsOtp\": true,\n \"supportsCardinalAuthentication\": false,\n \"loyaltyRedeemEnabled\": true,\n \"loyaltyEnabled\": true,\n \"supportsFingerPrintAuthorization\": true,\n \"supportsAccountType\": true,\n \"supportsVisaAcceleratedConnectionPlatform\": false,\n \"supportsCybersource20\": false,\n \"cybersourceEnabled\": false\n }\n },\n {\n \"cardTypeCode\": \"QTM\",\n \"cardTypeName\": \"VERVE ECASH\",\n \"maskedPan\": \"561233*********6573\",\n \"accountNumber\": \"561************6573\",\n \"cardIdentifier\": \"00997A9CD6F7F5EA6EE170AB57D4BDC3E18163A34000129BC\",\n \"cardHash\": \"BE1C7E844EC085DD0DCEE59E5D5D9810\",\n \"walletInstrumentIdentifier\": \"189E7A8944084E0EAB41A6D11AF5B76A\",\n \"status\": \"Active\",\n \"expiryMonth\": \"03\",\n \"expiryYear\": \"50\",\n \"issuer\": {\n \"id\": 101,\n \"name\": \"FIRST BANK OF NIGERIA\",\n \"code\": \"FBN\",\n \"domainTypeId\": 1,\n \"countryCode\": \"NG\",\n \"cbnCode\": \"011\"\n },\n \"name\": \"Verve eCash\",\n \"cookieKey\": \"F62E94D72FC0352E80A3322BA1E292B5EB76B279\",\n \"loyaltyRedemptionAllowed\": false,\n \"maskToken\": false,\n \"enableFingerPrint\": false,\n \"cardTypeGatewayConfiguration\": {\n \"id\": 4,\n \"supportsPin\": true,\n \"supportsCvv2\": false,\n \"supportsExpiryDate\": false,\n \"enabled\": true,\n \"cardTypeCode\": \"QTM\",\n \"supportsOtp\": false,\n \"supportsCardinalAuthentication\": false,\n \"loyaltyRedeemEnabled\": true,\n \"loyaltyEnabled\": true,\n \"supportsFingerPrintAuthorization\": false,\n \"supportsAccountType\": false,\n \"supportsVisaAcceleratedConnectionPlatform\": false,\n \"supportsCybersource20\": false,\n \"cybersourceEnabled\": false\n }\n }\n ],\n \"user\": {\n \"id\": null,\n \"username\": null,\n \"email\": \"dadubiaro@interswitch.com\",\n \"mobileNo\": \"2348124888436\",\n \"firstName\": \"Deborah\",\n \"lastName\": \"Adubiaro\",\n \"passportId\": null,\n \"active\": true,\n \"admin\": false,\n \"domainId\": null,\n \"domainName\": null,\n \"domainCode\": null,\n \"roleId\": null,\n \"roles\": null,\n \"domains\": null,\n \"apps\": null\n }\n}" } }, "schema": { "type": "object", "properties": { "paymentMethods": { "type": "array", "items": { "type": "object", "properties": { "cardTypeCode": { "type": "string", "example": "VVC" }, "cardTypeName": { "type": "string", "example": "VERVE" }, "maskedPan": { "type": "string", "example": "506099*********5521" }, "accountNumber": { "type": "string", "example": "" }, "cardIdentifier": { "type": "string", "example": "03D9535A42C0A484452A4C2A8CBC04FD4019B65949A83CC14" }, "cardHash": { "type": "string", "example": "112C45C4D3C9955A401006C1462F4369" }, "walletInstrumentIdentifier": { "type": "string", "example": "6820DEB3360E4EE893267E2E7EB5AEE4" }, "status": { "type": "string", "example": "Active" }, "expiryMonth": { "type": "string", "example": "04" }, "expiryYear": { "type": "string", "example": "50" }, "issuer": { "type": "object", "properties": { "id": { "type": "integer", "example": 101, "default": 0 }, "name": { "type": "string", "example": "FIRST BANK OF NIGERIA" }, "code": { "type": "string", "example": "FBN" }, "domainTypeId": { "type": "integer", "example": 1, "default": 0 }, "countryCode": { "type": "string", "example": "NG" }, "cbnCode": { "type": "string", "example": "011" } } }, "name": { "type": "string", "example": "FirstBank Master Card" }, "cookieKey": { "type": "string", "example": "62CC6E8B48FABEA08D56790F379049C788999AB2" }, "loyaltyRedemptionAllowed": { "type": "boolean", "example": false, "default": true }, "maskToken": { "type": "boolean", "example": true, "default": true }, "enableFingerPrint": { "type": "boolean", "example": false, "default": true }, "cardTypeGatewayConfiguration": { "type": "object", "properties": { "id": { "type": "integer", "example": 1, "default": 0 }, "supportsPin": { "type": "boolean", "example": true, "default": true }, "supportsCvv2": { "type": "boolean", "example": true, "default": true }, "supportsExpiryDate": { "type": "boolean", "example": true, "default": true }, "enabled": { "type": "boolean", "example": true, "default": true }, "cardTypeCode": { "type": "string", "example": "VVC" }, "supportsOtp": { "type": "boolean", "example": true, "default": true }, "supportsCardinalAuthentication": { "type": "boolean", "example": false, "default": true }, "loyaltyRedeemEnabled": { "type": "boolean", "example": true, "default": true }, "loyaltyEnabled": { "type": "boolean", "example": true, "default": true }, "supportsFingerPrintAuthorization": { "type": "boolean", "example": true, "default": true }, "supportsAccountType": { "type": "boolean", "example": true, "default": true }, "supportsVisaAcceleratedConnectionPlatform": { "type": "boolean", "example": false, "default": true }, "supportsCybersource20": { "type": "boolean", "example": false, "default": true }, "cybersourceEnabled": { "type": "boolean", "example": false, "default": true } } } } } }, "user": { "type": "object", "properties": { "id": {}, "username": {}, "email": { "type": "string", "example": "dadubiaro@interswitch.com" }, "mobileNo": { "type": "string", "example": "2348124888436" }, "firstName": { "type": "string", "example": "Deborah" }, "lastName": { "type": "string", "example": "Adubiaro" }, "passportId": {}, "active": { "type": "boolean", "example": true, "default": true }, "admin": { "type": "boolean", "example": false, "default": true }, "domainId": {}, "domainName": {}, "domainCode": {}, "roleId": {}, "roles": {}, "domains": {}, "apps": {} } } } } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Result": { "value": "{}" } }, "schema": { "type": "object", "properties": {} } } } } }, "deprecated": false, "security": [] } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```