Update Cardholder

post

https://api.laticards.org/api/v1/issuing/cardholders/{cardholder_id}

Updates the specified issuing cardholder object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

cardholder_id

uuid

required

Universally unique identifier (UUID v4) of a cardholder.

Body Params

string

The cardholder’s email address.

first_name

string

required

The first name of the cardholder. Must be between 1 and 40 characters, containing only alphabetic characters and spaces. Spaces are not allowed at the beginning or end of the name.

last_name

string

required

The last name of the cardholder. Must be between 1 and 40 characters, containing only alphabetic characters and spaces. Spaces are not allowed at the beginning or end of the name.

gender

integer

enum

required

The cardholder's gender. 1 means male, 2 means female.

Allowed:

date_birth

string

The cardholder's birth date with yyyy-mm-dd format.

country_code

string

length ≤ 2

Two-letter country code ISO 3166-1 alpha-2.

nationality

string

length ≤ 8

The cardholder's nationality code. Send an empty string to clear the saved value.

phone_number

string

required

The cardholder’s phone number.

delivery_address

object

The cardholder’s delivery address. When provided, include all standard address keys. district and line_en are accepted as optional delivery-only fields.

id_type

integer

enum

Identification document type. 1 and 2 are accepted.

Allowed:

id_number

string

length ≤ 128

Identification document number.

occupation

integer

1 to 13

Occupation code. Values from 1 to 13 are accepted.

id_front_image

string

length ≤ 1024

Front image URL or object key for the identification document.

id_back_image

string

length ≤ 1024

Back image URL or object key for the identification document.

holder_image

string

length ≤ 1024

Holder portrait image URL or object key.

Headers

x-on-behalf-of

string

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts. If omitted or empty, the request is executed using the master account.
More information at Connected Accounts.

x-idempotency-key

uuid

required

A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.

Responses

200Cardholder update successfully.

400Bad Request - The request was unacceptable, often due to missing a required parameter.

401Unauthorized - No valid API key or token provided.