Skip to main content

Suspend, Resume & Terminate Card

Manage a card's operational status. All three operations are async and return 204 No Content.

Suspend Card​

Temporarily freezes the card. The card cannot be used for payments while suspended. It can be resumed at any time.

Endpoint​

POST /api/v2/organizations/{org_id}/wallets/{wallet_id}/instruments/{instrument_id}/suspend

Request​

curl -X POST "https://api.4pay.cc/api/v2/organizations/{org_id}/wallets/{wallet_id}/instruments/{instrument_id}/suspend" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response​

204 No Content

After suspension, polling Get Card Details should show status: "frozen".

Resume Card​

Reactivates a previously suspended (frozen) card.

Endpoint​

POST /api/v2/organizations/{org_id}/wallets/{wallet_id}/instruments/{instrument_id}/resume

Request​

curl -X POST "https://api.4pay.cc/api/v2/organizations/{org_id}/wallets/{wallet_id}/instruments/{instrument_id}/resume" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response​

204 No Content

After resumption, status should return to active.

Terminate Card​

Permanently closes the card. This action is irreversible — the card cannot be reactivated.

Irreversible action

Once terminated, the card cannot be restored. Any remaining balance should be defunded back to the wallet before terminating.

Endpoint​

POST /api/v2/organizations/{org_id}/wallets/{wallet_id}/instruments/{instrument_id}/terminate

Request​

curl -X POST "https://api.4pay.cc/api/v2/organizations/{org_id}/wallets/{wallet_id}/instruments/{instrument_id}/terminate" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response​

204 No Content

After termination, status becomes closed.

Status Transition Summary​

active   →  suspend  →  frozen
frozen   →  resume   →  active
active   →  terminate →  closed  (irreversible)
frozen   →  terminate →  closed  (irreversible)