Cardholder

In Pliant a cardholder is the actual human being that has ownership of one or multiple cards.

Since a cardholder is a member of an organization, he/she has one or more roles in regard to the organization. Roles have a hierarchy, therefore higher roles also get the lower roles assigned. The common roles are, in hierarchical order:

  • Owner
  • Cardholder

Data Model

Field

Type

Description

cardholderId

uuid

Unique identifier for the cardholder

salutation

string

MR or MRS

firstName

string

First name of the cardholder as recorded in our system

lastName

string

Last name of the cardholder as recorded in our system

email

string

Email address of the cardholder as recorded in our system. Must be validated as it is the username for logging into the web & mobile applications.

phoneNumber

string

Phone number of the cardholder as recorded in our system. Must be a mobile number to be able to receive SMS (used for two-factor authentication)

language

string

DE, EN, etc.

isOwner

boolean

Flag to identifier if the cardholder has owner permissions

status

string

The current state of the cardholder, either:
INVITED
ACTIVE
INACTIVE

Example Data

{
  "cardholderId": "6e545ed3-a303-4da4-b419-757916ce15cd",
 	"saluation": "MR",
  "firstName": "Jane",
  "lastName": "Doe",
  "email": "[email protected]",
  "phoneNumber": "+491234567890",
  "language": "en",
  "isOwner": true,
  "status": "INVITED"
}

State Machine