post https://example.com/programs//externalcards
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
| Code | subCode | Description |
|---|---|---|
| 5 | 320 | Unsupported Card |
| 5 | 315 | Not a US card |
| 5 | 316 | Not a Debit or Prepaid Card |
| 5 | 317 | Card other than Visa/MC |
| 5 | 370 | The card has expired |
| 5 | 318 | Max Cards already reached in the wallet |
| 0 | 0 | Success |
