---
title: "Delete Payment Method"
method: DELETE
path: "/customers/{id}/payment-methods/{tokenId}"
tags: ["Customers"]
---

# Delete Payment Method

`DELETE /customers/{id}/payment-methods/{tokenId}`

## Request

- Base URL: `https://api.monei.com/v1`
- URL: `https://api.monei.com/v1/customers/{id}/payment-methods/{tokenId}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/monei/apis/monei-api-v1/docs/customers/:id/payment-methods/:tokenId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Deletes one of a customer's saved payment methods.

**Refused while it is still billing**:

The request fails with `409` when a subscription that is `ACTIVE`, `TRIALING`, `PAUSED` or `PAST_DUE` is charging this payment method. Cancel or move that subscription first.

**If it was the default**:

Deleting the customer's `defaultTokenId` clears it, rather than silently moving the default to another card. While the customer has no default, a payment sending `useDefaultPaymentMethod` is rejected.

The field does not stay empty for good: MONEI fills an empty default with the next reusable payment method the customer saves, the same rule that set the first one. Set `defaultTokenId` yourself if you need to choose which.

## Response `200`

The resource was deleted

- DeletedResource
  - `success` boolean, required: Always `true`. The request failed otherwise.

## Other responses

- `400`: The request is incorrect or could not be processed
- `401`: Unauthorized error. Please check your auth credentials
- `404`: The specified resource was not found
- `409`: The request conflicts with the current state of the resource
- `422`: The request was well-formed but could not be processed due to semantic errors
- `500`: Unexpected server error
- `503`: The service is temporarily unavailable

## Changes

- **2026-10-02** `2d67a2ee1e00`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monei/apis/monei-api-v1/changes/customers/:id/payment-methods/:tokenId/delete.md)

---

[API](https://skmtc.dev/monei/apis/monei-api-v1.md) - [All operations](https://skmtc.dev/monei/apis/monei-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/monei/apis/monei-api-v1/revisions/50bc7df2aa43?raw)