Card Object

The Card object represents the card attached to an external or integrated card Financial Account, such as a debit card or credit card.

Attributes

firstName

string, min length: 1, max length: 40

First name of the Customer or Recipient, as it appears on the card.

middleName

string, min length: 1, max length: 40

Middle name of the Customer or Recipient, as it appears on the card.

lastName

string, min length: 1, max length: 40

Last name of the Customer or Recipient, as it appears on the card.

cardNumberTail

string, max length: 4

Last 4 digits of the card number.

expiry

string, format: yyyy-MM

Expiry date for the card.

billingAddress

object

Billing address for the card.

addressLine1

string, min length: 1, max length: 50

Address line 1.

addressLine2

string, min length: 1, max length: 50

Address line 2.

addressLine3

string, min length: 1, max length: 50

Address line 3.

city

string, min length: 1, max length: 25

City.

stateCode

string, min length: 2, max length: 3

State, province, or territory. Required if country is USA or CAN. Must be an ISO 3166-2 uppercase alpha 2-character or 3-character country subdivision code. For example, Missouri is MO and Ontario is ON.

countryCode

string, min length: 3, max length: 3

Country. Must be an ISO 3166-1 uppercase alpha 3-character country code. For example, the United States is USA and Canada is CAN.

postalCode

string, min length: 1, max length: 10

ZIP code or postal code. For US addresses, must be a valid value of 5 digits (example: 63368) or 5 digits-4 digits (example: 63368-5555). Can be alphanumeric for other countries.

Card Object

				
					{
  "firstName": "Mark",
  "middleName": "David",
  "lastName": "Strong",
  "cardNumberTail": "4242",
  "expiry": "2027-12",
  "billingAddress": {
    "addressLine1": "625 Queen St",
    "addressLine2": "Suite 201",
    "addressLine3": "South Building",
    "city": "Vancouver",
    "stateCode": "BC",
    "countryCode": "CAN", * country
    "postalCode": "V5K 0A1"
  }
}