Update Cardholder

Used mainly for email communication.

The first name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: A-Z, a-z, 0-9, äöüÄÖÜ.- The combined length of first name and last name must not exceed 24 characters. One additional character is reserved for the space inserted between them when displayed on the card (25 characters in total). The full legal first name must be provided, since it is used for sanctions screening. Initial-only values are rejected: a single letter (e.g. K), a single letter followed by a period (e.g. K.) and sequences of initials with or without periods (e.g. J R, J. R.). Short names with two or more letters (e.g. Li, Ng, Wu, Xu) are valid. A violation results in a 400 Bad Request with the error code INCOMPLETE_LEGAL_NAME.

The last name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: A-Z, a-z, 0-9, äöüÄÖÜ.- The combined length of first name and last name must not exceed 24 characters. One additional character is reserved for the space inserted between them when displayed on the card (25 characters in total). The full legal last name must be provided, since it is used for sanctions screening. Initial-only values are rejected: a single letter (e.g. K), a single letter followed by a period (e.g. K.) and sequences of initials with or without periods (e.g. J R, J. R.). Short names with two or more letters (e.g. Li, Ng, Wu, Xu) are valid. A violation results in a 400 Bad Request with the error code INCOMPLETE_LEGAL_NAME.

The email address of the cardholder. This will be used for email communication. If the email address is updated for cardholder that has been invited via API or Pliant apps, an email notification is triggered.

The phone number must start with + followed by 8 to 15 numbers, e.g. +49123456789. If the phone number of a cardholder is updated, who was invited via Pliant and not the API, the phone number is not changed immediately, but the cardholder will receive an email instead with instructions to re-login to Pliant's web app and to update the phone number there. This is necessary as a security precaution, since the phone number is a critical part of the 3DS authentication process for handling purchases with a credit card.

Used for setting the language in Pliant apps as well as for email communication.

Optional locale. When provided, its language subtag must match language.

If true, the cardholder is the owner of the organization. The owner is allowed to administer all settings of the organization on the Pliant platform. If false, the cardholder is a plain cardholder with limited rights on the Pliant platform. Only works if cardholder was invited via API or Pliant apps.

The date-of-birth of the cardholder. Depending on the compliance configuration of your payment program, this field may be required. Omitting it in those cases will result in a 400 Bad Request.

The nationality of the cardholder (ISO 3166-1 alpha-2). Depending on the compliance configuration of your payment program, this field may be required. Omitting it in those cases will result in a 400 Bad Request.

The unique identifier of the cardholder.

The salutation of the cardholder. Mainly used for email communication.

The first name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: A-Z, a-z, 0-9, äöüÄÖÜ.- The combined length of first name and last name must not exceed 24 characters. One additional character is reserved for the space inserted between them when displayed on the card (25 characters in total).

The last name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: A-Z, a-z, 0-9, äöüÄÖÜ.- The combined length of first name and last name must not exceed 24 characters. One additional character is reserved for the space inserted between them when displayed on the card (25 characters in total).

The email address of the cardholder. This will be used for email communication.

Phone number must start with + followed by 8 to 15 numbers, e.g. +49123456789. Important! When changing the phone number, the new phone number must be verified by the cardholder within Pliant, if the cardholder has access to Pliant web app. If the cardholder has no access to Pliant, the phone number is changed without an additional verification, but with a short delay of some seconds. You will receive a callback once the cardholder is fully updated.

Used for setting the language in Pliant apps as well as for email communication.

Optional locale. When provided, its language subtag must match language.

Describes if the cardholder is eligible to have platform fee cards assigned to them. Note, that this field depends on the organization. The combination of cardholderId and organizationId defines if this field is true or false.

If true, the cardholder is the owner of the organization. The owner is allowed to administer all settings of the organization on the Pliant platform. If false, the cardholder is a plain cardholder with limited rights on the Pliant platform.

The status of the cardholder.

Describes if the cardholder is embedded with a partner and thus can only be managed via the API. If true, it can only be managed via API, if false, if can be managed via UI as well and the cardholder can also log into Pliant web app.

The date-of-birth of the cardholder.

The nationality of the cardholder (ISO 3166-1 alpha-2).