Update Cardholder
Updates cardholder details.
Path parameters
The unique identifier of the cardholder.
Query parameters
The unique identifier of the organization.
Request body
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, äöüÄÖÜ.- Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards).
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, äöüÄÖÜ.- Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards).
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.
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.
Response
Cardholder successfully updated.
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, äöüÄÖÜ.- Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards).
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, äöüÄÖÜ.- Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards).
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.
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).