Create Cardholder

POST Create Cardholder

POST /api/mastercard/holderCreate.html

Create a cardholder. Status: 0 - Pending review, 1 - Under review, 2 - Approved, 3 - Rejected.

Request Body Example

JSON

{
  "address": "Laisvés pr. 60",
  "countryCode": "LT",
  "dateOfBirth": "1994-04-10",
  "email": "[email protected]",
  "firstName": "JohnA",
  "idno": "ABC12345633",
  "idnoType": 2,
  "lastName": "DoeA",
  "mobile": "[phone]",
  "nationality": "US",
  "postCode": "05120",
  "randomStr": "abcdef12345678901",
  "sex": 1,
  "town": "Vilnius"
}

Request Parameters

Name	Type	Required	Base64 Encoded	Field Name	Description
mobile	string	true	none	Mobile Number	Country code + phone number ([phone])
lastName	string	false	Y	Last Name	Last name
firstName	string	true	Y	First Name	First name
email	string(email)	true	none	Email	Email address
dateOfBirth	string	true	none	Date of Birth	Date of birth (yyyy-MM-dd)
nationality	string	true	none	Nationality	Nationality (two-letter country code)
sex	integer	true	none	Gender	Gender: 1 - Male, 2 - Female
countryCode	string	true	none	European Country Code	Country code (two-letter country code)
town	string	true	Y	European Region	European region or city name (in English)
address	string	true	Y	European Address	European address details (in English)
postCode	string	true	none	Postal Code	Postal code
idnoType	integer	true	none	ID Document Type	ID document type: 1 - European ID card (supported for European nationality only), 2 - Passport
idno	string	true	none	ID Document Number	ID document number
randomStr	string	true	none	Random String	Random string with a length of 32 characters

Response Example

200 Response

JSON

{
  "auditStatus": 0,
  "errMsg": "string",
  "firstName": "string",
  "holderId": "string",
  "idno": "string",
  "idnoType": 0,
  "lastName": "string",
  "mobile": "string"
}

Response Parameters

Name	Type	Required	Constraints	Description
auditStatus	integer	true	none	Audit status,0: Pending review, 1: Under review, 2: Approved, 3: Rejected, 4: Data to be completed
errMsg	string	true	none	Description
firstName	string	true	none	First Name
holderId	string	true	none	Cardholder ID
idno	string	true	none	ID Document Number
idnoType	integer	true	none	ID Document Type
lastName	string	true	none	Last Name
mobile	string	true	none	Mobile Number