---
title: "Remove one of the current user's saved cards"
method: DELETE
path: "/v1/billing/payment-method/cards/{cardId}"
tags: ["Billing"]
---

# Remove one of the current user's saved cards

`DELETE /v1/billing/payment-method/cards/{cardId}`

Deletes the card at the gateway (token delete + card-on-file consent revoke) and retires it in the vault. When the primary card is removed and other cards remain, the freshest remaining one becomes primary and live subscriptions are repointed onto it. The only card of a subscription that still renews cannot be removed (400 `last_card_on_active_subscription`) — the client cancels the autorenew first and retries.

## Path parameters

- `cardId` string, uuid, required

## Response `204`

## Other responses

- `400` — last_card_on_active_subscription / saved_cards_not_supported
- `404` — Not this user's card

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)