The endpoint is used to retrieve or update the cardholder's name associated with a specific card request.
This endpoint is accessible for
KYC_0level and higher
Data Validation: First Name and Last Name
When entering the first and last name for creating or updating a cardholder's profile, the following validation rules are applied:
1. Character Length Validation:
- Virtual Card: The combined length of the first and last name must not exceed 27 characters (including spaces).
- Plastic Card: Each input field (first name and last name) must not exceed 13 characters (including spaces).
2. Allowed Characters:
- Only Latin letters (A-Z), digits (0-9), spaces, and hyphens (-) are allowed.
- Regional characters (e.g., ě, ć) and any other non-standard Latin characters are not permitted.
- Special characters such as
;:!?<>~\%^@{}|[]”_` are not allowed and will not appear when entered.
3. Validation Example:
- Valid Input: "JOHN DOE"
- Invalid Input: "JOHN! DOE@" — the characters
!and@will not be accepted. - Exceeding Character Limit: Entering "CHRISTOPHER" for the first name and "JONATHANSON" for the last name for a plastic card will trigger an error because each field exceeds the 13-character limit.
These validation rules ensure consistency and readability of the name on cards and prevent errors during card creation and usage.
The backend imposes a total limit of 27 characters. One character is used for the separator that will be inserted between the first and last names (e.g., a period). The remaining 26 characters are divided between the first and last name fields, typically 13 characters each. However, partners have the flexibility to adjust this division, such as allocating 1 character for the first name and 25 for the last name