Update Cardholder

Updates the cardholder's personal information for an existing account. Only parameters to be modified should be provided. Parameters that are not being modified do not need to be included in the request.
The field patterns should be checked in the Field Validation section of the Create Cardholder endpoint.

Request

FieldRequiredTypePatternDescription
first_nameNoString"1-30 characters; letters(A-Za-z), spaces, numbers, as well as hyphens (-) and single quote characters (').Cardholder's first name
last_nameNoString2-30 characters; letters(A-Za-z), spaces, numbers, as well as hyphens (-) and single quote characters (').HarleyCardholder's last name
middle_nameNoString2-30 characters; letters(A-Za-z), spaces, numbers, as well as hyphens (-) and single quote characters (').HarleyCardholder's middle name
emboss_line2Note Yet SupportedStringAlphanumeric 0-28 characters in length, "-" and spaces allowed.Example 2nd Line EmbossNote Yet Supported. Second line card emboss text.
date_of_birthNoDateYYYY-MM-DD, minimum age per the business rules for the program.1980-01-01Cardholder's birth date
address1NoString
address2NoString
cityNoStringLetters, "-", "'" and spaces, maximum length 20 characters.Salt Lake CityCardholder's city
stateNoStringValid 2 character state abbreviation.UTCardholder's state
postal_codeNoString12345 or 12345-1234 (US), K1A-1A1 (CA)18412Cardholder's postal code (zip code)
countryNoNumberThree digit country code.840Three digit ISO numeric UN M49 country code; Example USA=840, Canada=124.
phoneNoNumberValid phone number 8013656050Cardholder's primary phone number
emailNoStringEmail Address [email protected]Cardholder's email
sinSee DescriptionStringThis is a required field for all U.S. programs that require a KYC verification check. It is an optional field for programs issued in Canada. When provided, a KYC verification will be done based on the cardholder demographic data provided as part of this API call.
shipping_methodNoStringSee table belowUse shipping method to send the new card plastic. Note that this field is not required if you are issuing Virtual Cards.

Response

Field NameTypeDescription
external_tagStringUser-defined refenrece field - "abc1234"
idIntegerCardholder ID - "3"
processor_referenceIntegerCard proxy number - "999900217780"
program_idStringClient specific program ID - "1"
virtual_cardStringWhether the card is a virtual card or not - "false"
Language
URL
Click Try It! to start a request and see the response here!