post https://api.staging.pungle.co/api/v1/card_issuing/cardholders/
Updates the cardholder's personal information for an existing account. Provide only the parameters that require modification. 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
| Field | Required | Type | Pattern | Description |
|---|---|---|---|---|
| first_name | No | String | "1-30 characters; letters(A-Za-z), spaces, numbers, as well as hyphens (-) and single quote characters ('). | Cardholder's first name |
| last_name | No | String | 2-30 characters; letters(A-Za-z), spaces, numbers, as well as hyphens (-) and single quote characters (').Harley | Cardholder's last name |
| middle_name | No | String | 2-30 characters; letters(A-Za-z), spaces, numbers, as well as hyphens (-) and single quote characters (').Harley | Cardholder's middle name |
| emboss_line2 | Note Yet Supported | String | Alphanumeric 0-28 characters in length, "-" and spaces allowed.Example 2nd Line Emboss | Note Yet Supported. Second line card emboss text. |
| date_of_birth | No | Date | YYYY-MM-DD, minimum age per the business rules for the program.1980-01-01 | Cardholder's birth date |
| address1 | No | String | ||
| address2 | No | String | ||
| city | No | String | Letters, "-", "'" and spaces, maximum length 20 characters.Salt Lake City | Cardholder's city |
| state | No | String | Valid 2 character state abbreviation.UT | Cardholder's state |
| postal_code | No | String | 12345 or 12345-1234 (US), K1A-1A1 (CA)18412 | Cardholder's postal code (zip code) |
| country | No | Number | Three digit country code.840 | Three digit ISO numeric UN M49 country code; Example USA=840, Canada=124. |
| phone | No | Number | Valid phone number 8013656050 | Cardholder's primary phone number |
| No | String | Email Address [email protected] | Cardholder's email | |
| sin | See Description | String | This 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_method | No | String | See table below | Use shipping method to send the new card plastic. Note that this field is not required if you are issuing Virtual Cards. |
Response
| Field Name | Type | Description |
|---|---|---|
| external_tag | String | User-defined refenrece field - "abc1234" |
| id | Integer | Cardholder ID - "3" |
| processor_reference | Integer | Card proxy number - "999900217780" |
| program_id | String | Client specific program ID - "1" |
| virtual_card | String | Whether the card is a virtual card or not - "false" |