Reissue Card
Header Parameters
Required client-generated UUID v4 used to deduplicate retried mutating requests (POST, PUT, PATCH, DELETE). Requests without this header are rejected with 400 Bad Request. The first successful (2xx) response is cached for 24h and replays of the same key return the cached response without re-executing the operation.
Path Parameters
The Globally Unique Identifier (GUID) for the card.
Response
Card replacement request accepted.
Response Attributes
A unique identifier for the request.
Human-readable message describing the operation result.
Invalid request or validation error. Possible causes include:
- Card not in
ACTIVEorREADY_TO_ACTIVATEstatus (INVALID_CARD_STATUS) - Unsupported provider (
UNSUPPORTED_PROVIDER) - Temporary card (
TEMP_CARD_NOT_ALLOWED) - Card pending today (
CARD_PENDING_TODAY) - Card expired (
CARD_EXPIRED) - EMV transition blocked (
EMV_TRANSITION_BLOCKED) - Provider does not support reissue (
PROVIDER_NOT_SUPPORTED) - Employer setting disabled (
EMPLOYER_SETTING_DISABLED)
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Unauthorized. Authentication failed.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Forbidden. User does not have permission to request a replacement for this card.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Card not found.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Conflict. The provided Idempotency-Key has already been used for a previous request. Each unique operation requires a new idempotency key.
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.
Unexpected error
Response Attributes
List of invalid parameters that caused the validation error.
Show child attributes
Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.
Field-level validation errors keyed by field name. Each key maps to one or more structured error details.