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

Send your API key as a bearer token: Authorization: Bearer <api_key>. A test mode key starts with dodo_test_, for example dodo_test_AbCd1234EfGh5678.<secret>. A live mode key starts with dodo_live_. Use a test mode key on test.dodopayments.com and a live mode key on live.dodopayments.com. Keys from before these tags have no tag and operate as before.

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