# Delete Customer Token

**Method:** `POST`

**Path:** `/api/v1/customer/{customer_id}/tokens/{token_id}/delete`

**Category:** Tokenization

**Authentication:** Required

## Description

Delete a specific token linked to a customer by both the customer ID and token ID.
Requires a unique merchant reference for the delete operation.


## Path Parameters

- `customer_id` (`string`) **required** — Unique identifier of the customer in the Pine Labs Online database.
- `token_id` (`string`) **required** — Unique token ID to delete.

## Request Body

Content-Type: `application/json`

- `merchant_unique_reference` (`string`) **required** — Unique reference for this delete operation.
- `merchant_metadata` (`object`) — Arbitrary key-value pairs for merchant use. Maximum 10 pairs, 256 characters each.

### Example Request

```json
{
  "merchant_unique_reference": "del-ref-001",
  "merchant_metadata": {
    "clientId": "DD",
    "transactionReferenceNo": "pine-1223",
    "merchantId": "1234",
    "tid": "9000990",
    "acquirerName": "HDFC_FSS",
    "isOfferDisplayRequired": "true",
    "OfferData": "UHJvZHVjdF9Db2RlPSIgIiZQcm9kdWN0X05hbWU9IiImUGF5bWVudF9Nb2RlPUJhbmsgRU1JJkNhcmRfVHlwZT1EZWJpdCBDYXJkJkJhbmtfTmFtZT1IREZDIERlYml0JkVNSV9UZW51cmU9NiZJbnRlcmVzdF9SYXRlPTkuMCZJbnRlcmVzdF9BbW91bnQ9MTM4MTQwJk1vbnRobHlfSW5zdGFsbG1lbnQ9ODk0NjkwJkF1dGhvcml6YXRpb25fQW1vdW50PTEwMCZMb2FuX2Jvb2tpbmdfQW1vdW50PTUyMzAwMDAmSW50ZXJlc3RfQ2FzaGJhY2tfQW1vdW50PTAmSW50ZXJlc3RfQ2FzaGJhY2tfVHlwZT1EZWZlcnJlZCZBZGRpdGlvbmFsX0Nhc2hiYWNrPSIiJkFkZGl0aW9uYWxfQ2FzaGJhY2tfVHlwZT0iIiZEZXNjcmlwdGlvbj1CYW5rIEVNSSZQcm9kdWN0X1ZhbHVlPTUyMzAwMDA",
    "tenant_id": "PGATPOS",
    "is_offer_validation_required": "true"
  }
}
```

## Responses

- `200` — Customer token deleted successfully.
- `400` — 
- `401` — 
- `403` — 
- `404` — 
- `500` — 

### Response Schema

- `token_id` (`string`) — Token ID that was deleted.
- `customer_id` (`string`) — Unique identifier of the customer.
- `status` (`string`) — Status of the token after deletion.
- `merchant_unique_reference` (`string`) — Unique reference for this delete operation.

### Example Response

```json
{
  "token_id": "token-v1-0811030624-aa-RBDgpR",
  "customer_id": "cust-v1-0811030624-aa-RBDgpR",
  "status": "DELETED",
  "merchant_unique_reference": ""
}
```

---

Reference: https://localhost:3000/api/tokenization/delete-customer-token