> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withgale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove a Payment Method

> Remove a stored card so it can no longer be charged

# Remove a Payment Method

Removes the stored card. Call this when the shopper asks you to stop using their card. A removed payment method cannot be charged or restored. Calling it again for the same ID returns the same result.

## Endpoint

```
DELETE /api/v2/payment-methods/{payment_method_id}
```

## Authentication

```bash theme={null}
Authorization: Bearer glm_test_YOUR_API_KEY
```

## Path Parameters

| Parameter | Type | Description |
| :- | :- | :- |
| `payment_method_id` | string | The payment method ID (`pm_...`) |

## Response

The payment method, with `status` set to `disabled`.

```json theme={null}
{
  "success": true,
  "message": "Payment method removed",
  "data": {
    "id": "pm_fc61f9c445dd477287c47052087dc91c",
    "type": "card",
    "brand": "visa",
    "last4": "1111",
    "exp_month": "03",
    "exp_year": "2030",
    "usage": "off_session",
    "status": "disabled",
    "checkout_id": "cs_abc123",
    "customer_email": "jane@example.com",
    "last_used_at": "2026-12-10T09:15:02Z",
    "created_at": "2026-11-10T21:04:11Z"
  }
}
```

## Errors

| Status Code | Error Code | Description |
| :- | :- | :- |
| 401 | `unauthorized` | Invalid API key |
| 404 | `PAYMENT_METHOD_001` | Unknown ID, or a payment method stored in the other mode |
| 503 | `PAYMENT_METHOD_014` | The payment method could not be removed right now. Safe to retry |

## Related

* [Payment Method Object](https://docs.withgale.com/api-reference/objects/payment-method.md)
* [Saved Payment Methods guide](https://docs.withgale.com/integration/saved-payment-methods.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.