Add or Validate External Bank Card

Adds or validates an external bank card for a customer using encrypted card data. This endpoint is intended for external and general use.

Sample Request Body

{
   "accountIdentifier":"76fc6cca-4119-4aef-a547-10c578d8354d",
   "encryptedExternalCardData":{
      "version":"string",
      "ephemeralPublicKey":"string",
      "publicKeyHash":"string",
      "data":"string"
   },
   "firstName":"John",
   "lastName":"Doe",
   "nickName":"JD",
   "action":"add", //Available options: add or null"
   "address1": "123 South Street", 
   "address2": "121", 
   "city": "Pasadena",
   "state": "CA", 
   "zip": "91107
}

Sample Unencrypted External Card Data with Sample Response

{
   "cvv":"123",
   "cardNumber":"5104410000000044",
   "expiration":{
      "month":"04",
      "year":"21"
   },
   "firstName":"John",
   "lastName":"Doe",
   "addressLine1":"123 South Street",
   "addressLine2":"121",
   "city":"Pasadena",
   "state":"CA",
   "zipCode":"91107"
}

Sample Unencrypted External Card Data Response

{
   "bankName":"string",
   "network":"visa",// Available options: mastercard, visa, or null 
   "fundingEligible":true,
   "withdrawalEligible":true,
   "accountExternalCardIdentifier":"c59f5f97-0971-4f9f-a59e-1711b37bfecc",
   "responseDetails":[
      {
         "code":0,
         "subCode":0,
         "description":"Success",
         "url":"http://tbd"
      }
   ]
}

Response Codes

CodesubCodeDescription
5320Unsupported Card
5315Not a US card
5316Not a Debit or Prepaid Card
5317Card other than Visa/MC
5370The card has expired
5318Max Cards already reached in the wallet
00Success
Language
Credentials
Header