Delete Customer Token

POST/api/v1/customer/{customer_id}/tokens/{token_id}/delete

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.

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Path Parameters

Name	Type	Description
`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

Name	Type	Description
`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.

Response

Name	Type	Description
`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.

Status Codes

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

Request

curl --request POST \
  --url https://pluraluat.v2.pinepg.in/api/v1/customer/cust-v1-0811030624-aa-RBDgpR/tokens/token-v1-1234567890-aa-ABCDEF/delete \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "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"
  }
}'

Run this request

Bearer token

Path parameters

customer_id

token_id

Request body (JSON)

200 OK

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