Update Card - Field Descriptions
The following page details each of the fields that can be used in the request, and received in the response when using the Update Card endpoint.
Request Fields
The following table describes fields that can be included in the body of the request when updating a card.
Field | Description | Minimum Length | Maximum Length | Type | Mandatory |
|---|---|---|---|---|---|
customerReference | An external customer reference provided in the request. | 0 | 25 | String | No |
language3ds | The language to apply to the 3DS challenge screens displayed to the cardholder. (In BCP-47 format. For example: en-EN,fr-FR.) Note: The language content must first be set up for your card products; once this is done, your 3DS Implementation Manager will share with you the language codes to use. Note: Default language is English. If card level value is not provided, then the product level setting will be used. | 0 | 20 | No | |
designId | The name of the card visual design. | 1 | 50 | String | No |
parentCard | Where the card is a secondary card, the public token of the primary card. | 9 | 10 | String | No |
freetext1 | A free text field to communicate details to the card manufacturer. | 1 | 50 | String | No |
freetext2 | A free text field to communicate details to the card manufacturer. | 1 | 50 | String | No |
updatedBy | User who updated the card details. | 0 | 100 | String | No |
networkSharingOptOut | Enables you specify whether the card should be opted out of the Visa Account Updater (VAU) or Automated Billing Updater (ABU), which provide merchants with account advice information. | ||||
url | This value is included in the Thredd Card Generation file, in the QRCode field. For example: https://www.example.com/QRBalance/123456789 For details, see the Card Generation Interface Specifications. | 0 | 100 | String | No |
oobAppUrl | 3DS OOBAppURL at card level. | 0 | 2048 | String | No |
cardHolder | The fields for the cardholder object are used to capture information on the cardholder. | ||||
title | Title of the cardholder. | 0 | 5 | String | Yes |
firstName | First name of the cardholder.
| 0 | 100 | String | Yes |
middleName | Middle name of cardholder.
| 0 | 100 | String | No |
lastName | Last name of the cardholder.
| 0 | 100 | String | Yes |
dateOfBirth | Date of Birth of the cardholder. Format YYYY-MM-DD. | 10 | 10 | String | Yes |
mobile | Mobile number of cardholder. | 0 | 16 | String | No |
Email address of the cardholder. | 0 | 100 | String | No | |
address | The fields for the address object are used to capture the cardholder's address. | ||||
addressLine1 | First line of the address. | 0 | 100 | String | Yes |
addressLine2 | Second line of the address. | 0 | 100 | String | No |
addressLine3 | Third line of the address. | 0 | 50 | String | No |
city | City name. | 0 | 50 | String | No |
county | County, region or province. | 0 | 50 | String | No |
postCode | Postcode / Zip code of the address. | 0 | 16 | String | Yes |
country | Country of residence. This is represented as a 3-letter alphanumeric ISO country code (e.g. GBR for UK). See the IBAN list of country codes for a full list. | 3 | 3 | String | Yes |
state | State of the address | 0 | 50 | String | No |
fulfilment | The fields for the fulfilment object are used to capture the cardholder's fulfilment address. | ||||
addressLine1 | First line of the address. | 0 | 100 | String | Yes |
addressLine2 | Second line of the address. | 0 | 100 | String | No |
addressLine3 | Third line of the address. | 0 | 50 | String | No |
city | City name. | 0 | 100 | String | No |
state | State. | 0 | 100 | String | No |
county | County, region or province. | 0 | 100 | String | No |
postCode | Postcode / Zip code of the address. | 0 | 16 | String | Yes |
country | Country of residence. This is represented as a 3-letter alphanumeric ISO country code (e.g. GBR for UK). See the IBAN list of country codes for a full list. | 3 | 3 | String | Yes |
nameOnCard | The name that appears on the card. Note this is mandatory for physical card types. | 0 | 26 | String |
|
manufacturingDetails | The fields for the manufacturingDetails object are used to capture the manufacturing details required for a physical card. | ||||
thermalLine1 | Free text field which can be used for transferring extra information to be printed on the card. | 0 | 120 | String | No |
thermalLine2 | Free text field which can be used for transferring extra information to be printed on the card. | 0 | 70 | String | No |
embossLine4 | Embossed card line 4. Actual maximum length will depend on the card design. | 0 | 27 | String | No |
config3dSecure | The fields for the config3dSecure obejct are used to display values related to 3DS configuration for the card. | ||||
language3ds | The language to apply to the 3DS challenge screens displayed to the cardholder. (In BCP-47 format. For example: en-EN,fr-FR.) Note: The language content must first be set up for your card products; once this is done, your 3DS Implementation Manager will share with you the language codes to use. Note: Default language is English. If card level value is not provided, then the product level setting will be used. | 0 | 20 | No | |
apataConfig | The fields for the apataConfig object are used to display values related to the Apata 3DS configuration for the card. | ||||
cardProgramId | Sets the card program identifier. | 0 | 255 | No | |
challengeProfileId | Sets the challenge profile identifier. | 0 | 255 | No | |
kbaNumberOfQuestionsToAnswer | Sets the KBA number of questions to answer. | No | |||
kbaNumberOfIncorrectPermissible | Sets the KBA number of incorrect permissible | No |