Card Status Change

Goal: freeze or unfreeze cards and confirm the new provider status.

Review the encrypted request rules in Overview before starting.

Workflow steps

Freeze or unfreeze
Provide external_user_id or cardholder_id with the target card identifiers.
Track order and card status
Poll order status and then verify the card state.

API Endpoints

POST/api/v1/cards/freezeFreeze an active card.
POST/api/v1/cards/unfreezeUnfreeze a frozen card.
POST/api/v1/orders/checkTrack the status change order.
POST/api/v1/cards/getConfirm the updated card status.

Schemas

OrderBase

Field	Type	Required	Description
`order_id`	string	Required	Order identifier.
`order_type`	string	Required	Order type (card_issue, card_topup, etc.).
`status`	string	Required	Overall order status. Enum: `new`, `paid`, `activating`, `processing`, `completed`, `failed`
`created_at`	string	Required	Order creation time (ISO 8601).
`updated_at`	string	Optional	Last update time (ISO 8601).
`completed_at`	string	Optional	Completion time (ISO 8601).
`failed_at`	string	Optional	Failure time (ISO 8601).

CardStatus

Field	Type	Required	Description
`card_id`	string	Required	Card identifier.
`status`	string	Required	Current card status. Enum: `pending_activation`, `active`, `frozen`, `closed`

Error table

These error slugs are common when changing card status.

Error Slug	Description
`external_user_id_required`	external_user_id is required if cardholder_id is missing.
`invalid_card_id`	Card identifier is invalid.
`card_not_found`	Card not found.
`cardholder_not_found`	Cardholder not found.
`card_issue_not_completed`	Card issue order is not completed yet.
`invalid_card_status`	Card status does not allow the requested action.
`provider_invalid_card_status`	Provider reported an unexpected status.
`provider_error`	Provider-specific failure.