Skip to main content
DELETE
/
api
/
canary
/
payment-methods
/
{id}
Detaches and deletes a saved payment method from a customer.

Path Parameters

id
string
required
The unique identifier of the payment method

Response

Success
id
string
Unique identifier for the deleted payment method
deleted
boolean
Confirmation that the payment method was deleted
deletedAt
string
ISO 8601 timestamp when the payment method was deleted

Example Response

{
  "id": "pm_001",
  "deleted": true,
  "deletedAt": "2025-01-15T10:30:00.000Z"
}

Error Responses

Unauthorized
Invalid or missing authentication token
Not Found
Payment method not found
Internal Server Error
An unexpected error occurred on the server

Authentication

This endpoint requires Bearer token authentication.