Skip to main content
DELETE
JavaScript
Remove a saved payment method from a customer’s account. Use this to clean up outdated or unwanted payment methods.
You cannot delete a payment method that is in use by an active subscription. The API returns 409 Conflict with Payment method is in use by an active subscription. Move the subscription to another payment method first using Update Payment Method, then delete the old one.
A successful delete returns 204 No Content.

Use Cases

  • Customer request: Remove a payment method the customer no longer wants on file
  • Expired cards: Clean up payment methods with expired card details
  • Security: Remove compromised payment methods immediately

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

customer_id
string
required

Customer Id

payment_method_id
string
required

Payment Method Id

Response

Payment method deleted successfully

Last modified on July 29, 2026