Cardholders

Invite Cardholder

Invite a new cardholder to Pliant. An invite email to the provided email address will be triggered, and the cardholder needs to register with Pliant using our registration flow. This means the cardholder is able to use Pliant web and mobile apps once fully registered. You will receive a callback once the cardholder is fully registered and can be used.

post/cardholders/invite

Request body

organizationIdstring uuid required

The ID of the organization.

salutation'MR' | 'MRS'

Used mainly for email communication

firstNamestring required

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).

lastNamestring required

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).

emailstring required

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

phoneNumberstring

Phone number must start with + followed by 8 to 15 numbers, e.g. +49123456789.

language'en' | 'de' | 'es' | 'fi' | 'fr' | 'it' | 'pt' | 'nl' | 'et' | 'el' | 'lv' | 'lt' | 'sk' | 'sl' | 'pl' required

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

isOwnerboolean required

If you want to invite the first owner (during onboarding and before authorization was granted) please use the endpoint POST /cardholders/invite-owner.

dateOfBirthstring date nullable

The date-of-birth of the cardholder.

nationalitystring nullable

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

Response

Cardholder is in creation process, wait for the callback to use it.

0 required— unresolved $ref

Changes