---
title: "Suspend a card"
method: POST
path: "/issuing/cards/{cardId}/suspend"
tags: ["Cards"]
---

# Suspend a card

`POST /issuing/cards/{cardId}/suspend`

## Request

- Base URL: `https://{prefix}.api.sandbox.checkout.com`
- URL: `https://{prefix}.api.sandbox.checkout.com/issuing/cards/{cardId}/suspend`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `string` scopes: `issuing:card-management-write`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/issuing/cards/:cardId/suspend/post.ts> (a function with typed inputs; its response is checked against the schema)

Suspends an `active` or `inactive` card to temporarily decline all incoming authorizations.

A `suspended` card can be reactivated.

## Path parameters

- `cardId` string, required: The card's unique identifier.

## Request body

- SuspendCardRequest
  - `reason` 'suspected_lost' | 'suspected_stolen': The reason why the card is being suspended.

## Response `200`

Card suspended successfully

- SuspendCardResponse
  - `_links` SuspendedCardLinks: The links related to the card.
    - `self` IssuingLink, required
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `activate` IssuingLink, required
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `revoke` IssuingLink, required
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource
    - `controls` IssuingLink, required
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource

## Other responses

- `401`: Unauthorized
- `404`: Card not found
- `422`: Invalid data was sent

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)