post https://sandbox-api.helix.q2.com/card/initiate
Initiate a request to create a new card and mail it to a customer. See card object definition for parameter details.
Warning In the Sandbox environment, cards are created with a
cardNumberMaskedvalue of1111and can be verified via /card/verify immediately.
Error Codes
Click to expand
| Code | Message (en-US) | Notes |
|---|---|---|
| 1-60000 | Any "Common Error Code" may occur. | See Common Error Codes |
| 63502 | Requesting customer does not have 'FULL' access to account id ’42031914'. | |
| 150201 | TypeCode {request.typeCode} is not valid. Must be "DBT" or "CDT". | |
| 150202 | VendorTypeCode {request.vendorTypeCode} is not valid. Must be "VS" or "MC". | |
| 150203 | NameOnCard is a required field. | |
| 150204 | Tag {request.tag} is already associated with another card. | |
| 150205 | Invalid Card Holder CustomerId {request.cardHolderCustomerid}. | |
| 150206 | Assigned Customer {request.cardHolderCustomerid} status is '{customer.status}.' Must be 'Initiated,' 'Manual Review,' or 'Verified'. | |
| 150208 | Invalid Primary AccountId {request.primaryAccountId}. | |
| 150209 | Primary AccountId {request.primaryAccountId} is in invalid status of {1}. Must be Open or PendingOpen. | |
| 150210 | Primary AccountId {request.primaryAccountId} must be a Checking or Savings account. | |
| 150211 | Insufficient access type {account.accessTypeCode} for CustomerId {request.cutomerid} to Primary AccountId {request.primaryAccountId} to add a card. FULL is required. | |
| 150212 | A Primary Account must be specified. | |
| 150213 | Both FirstName and LastName are required. | |
| 150230 | Another card for CustomerId {request.customerId} is using NickName of {request.nickName}. NickName must be unique. | |
| 150231 | The primary customer {request.customerId} must have its Mobile or Home phone specified prior to creating a card. | |
| 150232 | The primary customer {request.customerId} must have its Mailing or Residence address specified prior to creating a card. | |
| 150240 | FirstName ({request.firstName}) contains invalid characters. Refer to API documentation for valid characters. | For programs using Shazam |
| 150241 | MiddleName ({request.middleName}) contains invalid characters. Refer to API documentation for valid characters. | For programs using Shazam |
| 150242 | LastName ({request.lastName}) contains invalid characters. Refer to API documentation for valid characters. | For programs using Shazam |
| 150243 | Card Bin {request.binId} is not valid. | |
| 150244 | Program id {0} requires BankBinId to be specified. | |
| 150245 | Program id {0} does not have a valid bin set up. | |
| 150246 | FirstName ({request.firstName}) contains invalid characters. Refer to API documentation for valid characters. | For programs using Visa DPS |
| 150247 | MiddleName ({request.middleName}) contains invalid characters. Refer to API documentation for valid characters. | For programs using Visa DPS |
| 150248 | LastName ({request.lastName}) contains invalid characters. Refer to API documentation for valid characters. | For programs using Visa DPS |
| 150249 | Invalid value set for the IsPhysicalCardOrdered, value must be true to order physical card | |
| 155518 | DPS Validation Response: ({0}). | For programs using Visa DPSExample validation responses:- US zip code must be a valid zip code format |
- Card Qualifier must be a valid value for the institution
- US Social Security Number is invalid | | 201001 | Customer mailing address {0} cannot contain a PO Box. | | | 201000 | Customer mailing address not available | |