DELETE
/
customers
/
{customer_id}
/
instruments
/
{instrument_id}
Delete Saved Card Instrument
curl --request DELETE \
  --url https://sandbox.cashfree.com/pg/customers/{customer_id}/instruments/{instrument_id} \
  --header 'x-api-version: <x-api-version>' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>'
{
  "customer_id": "akshita2106",
  "afa_reference": "3128531647",
  "instrument_id": "54de41ad34ee-36a0-409e-aec9-bdc9d232add0",
  "instrument_type": "card",
  "instrument_uid": "78c2a3b90265436eceb4c09d8b09c85432ee1bb57512cc24ba998a12cd0180c2",
  "instrument_display": "XXXXXXXXXXXX1001",
  "instrument_status": "INACTIVE",
  "created_at": "2024-10-10T10:16:18.000+00:00",
  "instrument_meta": {
    "card_network": "mastercard",
    "card_bank_name": "ICICI BANK",
    "card_country": "IN",
    "card_type": "credit_card",
    "card_sub_type": "P",
    "card_token_details": {
      "par": "5001AJE6CSF757UMKRTKK61PRVYGC",
      "expiry_month": "11",
      "expiry_year": "2027"
    }
  }
}

Authorizations

​
x-client-id
string
header
required

Client app ID. You can find your app id in the merchant dashboard.

​
x-client-secret
string
header
required

Client secret key. You can find your secret key in the merchant dashboard.

Headers

​
x-api-version
string
default:2025-01-01
required

API version to be used. Format is in YYYY-MM-DD.

​
x-request-id
string

Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to Cashfree.

​
x-idempotency-key
string<UUID>

An idempotency key is a unique identifier you include with your API call. If the request fails or times out, you can safely retry it using the same key to avoid duplicate actions.

Path Parameters

​
customer_id
string
required

The customer ID provided by the merchant during the Create Order API call, used to save cards for the customer.

​
instrument_id
string
required

The instrument_id which needs to be deleted

Response

200
application/json

Delete saved card instrument object.