Delete a customer's payment method

Delete a specific saved payment method. The payment method is completely removed from the customer's saved payment methods.

To reuse a deleted payment method, direct your customer to the checkout page to save their card details again.

Request​

Path parameters
Path parameters

The ID of the Customer object.

The ID of the payment method.

Header parameters
Header parameters

Example: "Bearer sk_1234567890ABCdefGHIjklMNOpqrSTUvwxYZ_1234567890-Ab_cdeFGHijkLMNopq"

This parameter accepts the Merchant API Secret key to authorise requests coming from the merchant's backend.

It ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a Bearer token.

Info

For more information, see: Authentication

Possible values: [2024-09-01, 2025-10-16, 2025-12-04, 2026-03-12, 2026-04-20]
Example: "2026-04-20"

The version of the Merchant API, specified in YYYY-MM-DD format.

This endpoint is available from version 2024-09-01. If a version earlier than 2024-09-01 is provided, the endpoint returns a 404 response.

If not specified, you will receive an error.

Info

For more information about API versioning, see: API versions.

Response​

No Content
Was this page helpful?