Create a cardholder
POST/v1/cardholders
Creates the cardholder record that accounts and cards belong to.
A new cardholder starts with a kyc_status of not_started or
pending, depending on the program. A card can't be issued until the
status reaches approved.
Only individual cardholders are supported. Business cardholders will be supported in the future.
Request
Responses
- 201
- 400
- 401
- 403
- 409
- 422
- 429
Cardholder created.
Response Headers
Unique identifier for this request. Log it on every response — it is required in support tickets.
The request is malformed or contains an unrecognized parameter.
Credentials are missing, invalid, or expired. Do not retry.
Credentials are valid but not permitted. Do not retry.
Idempotency key reused with a different body, or a concurrent modification.
Well-formed but fails a business rule.
Rate limit exceeded. Honor Retry-After.
Response Headers
Seconds to wait before retrying.