> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 2. Fetch and Manage Tokens

> Retrieve, manage and cancel tokens using Razorpay APIs for UPI Autopay mandates.

Available in
🇮🇳 India

Once you capture a payment, Razorpay Checkout returns a `razorpay_payment_id`. You can use this id to fetch the `token_id`, which is used to create and charge subsequent payments.

You can retrieve the `token_id` using the [Dashboard](https://razorpay.com/docs/payments/recurring-payments/create.md#3-search-for-the-token) or the APIs given below.

## 2.1 What is a Token?

A token is a unique identifier that represents a registered UPI Autopay mandate between a customer and your business. When a customer approves a mandate through their UPI app during the [Initiate Mandate Registration](https://razorpay.com/docs/payments/payment-gateway/s2s-integration/recurring-payments/upi/authorization-transaction.md) step, Razorpay generates a `token_id` and associates it with the customer's `customer_id`.

The token stores the mandate's configuration, including the maximum debit amount, frequency and expiry date. You use this `token_id` every time you want to charge the customer a subsequent payment. A single customer can have multiple tokens for different mandates, for example, one for a monthly subscription and another for a quarterly insurance premium.

> [!NOTE]
>
> **Handy Tips**
>
> * Each token is tied to a specific payment method and customer. A token created via UPI cannot be used for card-based recurring payments and vice versa.
> * Tokens have a lifecycle with defined states. Always check the token state before attempting a subsequent debit. Know more in the [Token States](#2-2-token-states) section below.

## 2.2 Token States

A UPI Autopay token (mandate) transitions through the following states during its lifecycle. Ensure your integration handles all of these states to avoid unexpected failures.

| Token State | Description | Webhook generated |
| - | - | - |
| `initiated` | The mandate registration request has been sent to the customer's UPI app. The customer has not yet approved or rejected it. | No |
| `confirmed` | The customer has successfully approved the mandate, or has resumed a paused token. The token is active and can be used for subsequent debits. | Yes, `token.confirmed` |
| `rejected` | The customer rejected the mandate registration request from their UPI app. | Yes, `token.rejected` |
| `paused` | The mandate has been temporarily paused. No subsequent debits can be executed while the token is in this state. | Yes, `token.paused` |
| `cancellation_initiated` | The cancellation request has been submitted via the Cancel Token API. Razorpay is waiting for NPCI and the customer's bank to process and confirm the mandate closure. This is a temporary in-transit state. No subsequent debits can be executed while the token is in this state. | No |
| `cancelled` | The mandate has been permanently cancelled, either by the customer from their UPI app or by the merchant via the Cancel Token API. NPCI and the bank have confirmed the closure. No further debits are possible. The token also moves to the `cancelled` state if it has crossed its `expire_at` date and is no longer valid for debits. | Yes, `token.cancelled` |

> [!WARNING]
>
> **Watch Out!**
>
> * Only tokens in the `confirmed` state can be used to execute subsequent payments.
> * If a token transitions to `paused`, `cancellation_initiated` or `cancelled`, any subsequent payment attempt against that token will fail.
> * Tokens in the `cancellation_initiated` state will eventually transition to `cancelled` once NPCI confirms the closure. Do not treat `cancellation_initiated` as a final state.
> * Tokens in the `rejected` state indicate that the customer declined the mandate. You will need to initiate a new mandate registration for the customer.
> * Sometimes the customer cancels the token after the pre-debit notification (PDN) is sent. In such cases, you receive both the `token.cancelled` and the `payment.failed` webhooks.

## 2.3. Fetch Token by Payment ID

The following endpoint fetches the `token_id` using a `payment_id`.

`GET /payments/:id`

```bash Curl theme={null}
curl -u <YOUR_KEY_ID>:<YOUR_KEY_SECRET> \
-X GET https://api.razorpay.com/v1/payments/pay_1Aa00000000002
```

```java Java theme={null}
RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

String paymentId = "pay_1Aa00000000002";

Payment payment = razorpay.payments.fetch(paymentId)
```

```php PHP theme={null}
$api = new Api($key_id, $secret);

$api->payment->fetch($paymentId);
```

```javascript Node.js theme={null}
var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

instance.payments.fetch(paymentId)
```

```python Python theme={null}
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))

client.payment.fetch(paymentId)
```

```ruby Ruby theme={null}
require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')

paymentId = "pay_FHfAzEJ51k8NLj"

Razorpay::Payment.fetch(paymentId)
```

```go Go theme={null}
import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

body, err := client.Payment.Fetch("<paymentId>", nil, nil)
```

```csharp .NET theme={null}
RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

string paymentid = "pay_FHfqtkRzWvxky4";

Payment payment = client.Payment.Fetch(paymentid);
```

```json Debit Payment theme={null}
{
  "id": "pay_FHfAzEJ51k8NLj",
  "entity": "payment",
  "amount": 100,
  "currency": "INR",
  "status": "captured",
  "order_id": "order_FHfANdTUYeP8lb",
  "invoice_id": null,
  "international": false,
  "method": "upi",
  "amount_refunded": 0,
  "refund_status": null,
  "captured": true,
  "description": null,
  "card_id": null,
  "bank": null,
  "wallet": null,
  "vpa": "gaurav.kumar@upi",
  "email": "gaurav.kumar@example.com",
  "contact": "+919876543210",
  "customer_id": "cust_DtHaBuooGHTuyZ",
  "token_id": "token_FHfAzGzREc1ug6",
  "notes": {
    "note_key 1": "Beam me up Scotty",
    "note_key 2": "Tea. Earl Gray. Hot."
  },
  "fee": 0,
  "tax": 0,
  "error_code": null,
  "error_description": null,
  "error_source": null,
  "error_step": null,
  "error_reason": null,
  "acquirer_data": {
    "rrn": "854977234911",
    "upi_transaction_id": "D0BED5A062ECDB3E9B3A1071C96BB273"
  },
  "created_at": 1595447490
}
```

```json Authorisation Payment theme={null}
{
  "id": "pay_QDhVJ5M23wt4rh",
  "entity": "payment",
  "amount": 1000,
  "currency": "INR",
  "status": "failed",
  "order_id": "order_QDhT2PqFJvtg4y",
  "invoice_id": null,
  "international": false,
  "method": "upi",
  "amount_refunded": 0,
  "refund_status": null,
  "captured": false,
  "description": null,
  "card_id": null,
  "bank": null,
  "wallet": null,
  "vpa": "success@razorpay",
  "email": "gaurav.kumar@example.com",
  "contact": "+919123456780",
  "customer_id": "cust_Q0g6LTYw3obZEn",
  "token_id": "token_QDhVJHYr5m87fF",
  "notes": {
    "notes_key_1": "Tea, Earl Grey, Hot",
    "notes_key_2": "Tea, Earl Grey… decaf.",
    "note_key 1": "Beam me up Scotty",
    "note_key 2": "Tea. Earl Gray. Hot.",
    "optimizer_provider_name": "razorpay"
  },
  "fee": null,
  "tax": null,
  "error_code": "BAD_REQUEST_ERROR",
  "error_description": "Payment was a dummy payment for one time mandate registration.",
  "error_source": "business",
  "error_step": "payment_initiation",
  "error_reason": "upi_dummy_payment",
  "acquirer_data": {
    "rrn": null
  },
  "gateway_provider": "Razorpay",
  "created_at": 1743490280,
  "upi": {
    "vpa": "success@razorpay"
  }
}
```

> [!NOTE]
>
> **Handy Tips**
>
> You can also retrieve the `token_id` against the `payment_id` from the [payment.authorized webhook](https://razorpay.com/docs/api/payments/recurring-payments/webhooks.md#payment-authorized).

### Path Parameter

**id** `string` *required*

The unique identifier of the payment to be retrieved. For example, `pay_1Aa00000000002`.

### Response Parameters

> [accordion] Response Parameters
>
> **id** `string`
>
> Unique identifier of the payment.
>
> **entity** `string`
>
> Indicates the type of entity.
>
> **amount** `integer`
>
> The payment amount in currency subunits. For example, for an amount of ₹1 enter 100.
>
> **currency** `string`
>
> The currency in which the payment is made. Refer to the list of [international currencies](https://razorpay.com/docs/payments/international-payments#supported-currencies) that we support.
>
> **status** `string`
>
> The status of the payment. Possible values:
>
> * `created`
> * `authorized`
> * `captured`
> * `refunded`
> * `failed`
>
> **order\_id** `string`
>
> Order id, if provided. Know more about [Orders](https://razorpay.com/docs/payments/orders).
>
> **invoice\_id** `string`
>
> Unique identifier of the invoice associated with this payment. It is `null` when the registration is done using the API-based setup.
>
> **international** `boolean`
>
> Indicates whether the payment is done via an international card or a domestic one. Possible values:
>
> * `true`: Payment made using international card.
> * `false`: Payment not made using international card.
>
> **method** `string`
>
> The payment method used for making the payment. Possible values:
>
> * `card`
> * `netbanking`
> * `wallet`
> * `emi`
> * `upi`
> * `paylater`
>
> **amount\_refunded** `integer`
>
> The amount refunded in currency subunits. For example, if `amount_refunded = 100`, it is equal to ₹1.
>
> **refund\_status** `string`
>
> The refund status of the payment. Possible values:
>
> * `null`
> * `partial`
> * `full`
>
> **captured** `boolean`
>
> Indicates if the payment is captured. Possible values:
>
> * `true`: Payment has been captured.
> * `false`: Payment has not been captured.
>
> **description** `string`
>
> Description of the payment, if any.
>
> **card\_id** `string`
>
> The unique identifier of the card used by the customer to make the payment.
>
> **bank** `string`
>
> The 4-character bank code which the customer's account is associated with. For example, `UTIB` for Axis Bank.
>
> **wallet** `string`
>
> The name of the wallet used by the customer to make the payment. For example, `payzapp`.
>
> **vpa** `string`
>
> The customer's VPA (Virtual Payment Address) or UPI id used to make the payment. For example, `gauravkumar@exampleupi`.
>
> **email** `string`
>
> Customer email address used for the payment.
>
> **contact** `string`
>
> Customer contact number used for the payment.
>
> **customer\_id** `string`
>
> Unique identifier of the customer associated with this payment.
>
> **token\_id** `string`
>
> Unique identifier of the token associated with this payment. Use it to create subsequent payments.
>
> **notes** `object`
>
> Contains user-defined fields, stored for reference purposes.
>
> **fee** `integer`
>
> Fee (including GST) charged by Razorpay.
>
> **tax** `integer`
>
> GST charged for the payment.
>
> **error\_code** `string`
>
> Error that occurred during payment. For example, `BAD_REQUEST_ERROR`.
>
> **error\_description** `string`
>
> Description of the error that occurred during payment. For example, `Payment processing failed because of incorrect OTP`.
>
> **error\_source** `string`
>
> The point of failure. For example, `customer`.
>
> **error\_step** `string`
>
> The stage where the transaction failure occurred. The stages can vary depending on the payment method used to complete the transaction. For example, `payment_authentication`.
>
> **error\_reason** `string`
>
> The exact error reason. For example, `incorrect_otp`.
>
> **acquirer\_data** `object`
>
> An object containing unique reference numbers for the payment. For debit payments, it contains the `rrn` and `upi_transaction_id`.
>
> **gateway\_provider** `string`
>
> The payment provider used to process the payment. For example, `Razorpay`. It is returned when Optimizer is enabled for your account.
>
> **created\_at** `integer`
>
> Timestamp, in UNIX format, on which the payment was created.
>
> **upi** `object`
>
> Details of the UPI payment received. Only applicable if `method` is `upi`.
>
> **acquirer\_data.rrn** `string`
>
> A unique bank reference number provided by the banking partner for the payment. It is `null` for the authorisation payment.
>
> **acquirer\_data.upi\_transaction\_id** `string`
>
> Unique UPI transaction id for the payment. Returned for debit payments.
>
> **upi.vpa** `string`
>
> The customer's VPA (Virtual Payment Address) or UPI id used to make the payment. For example, `success@razorpay`.

## 2.4. Fetch Tokens by Customer ID

A customer can have multiple tokens and these tokens can be used to create subsequent payments for multiple products or services. The following endpoint retrieves tokens linked to a customer.

> [!WARNING]
>
> **Watch Out!**
>
> * This endpoint will not fetch the details of expired and unused tokens.
> * The UPI tokens are not populated in the API response if the `save_vpa` feature is not enabled in your account. Please raise a request with our [Support team](https://razorpay.com/support/#request) to get this activated.

`GET /customers/:id/tokens`

```bash Curl theme={null}
curl -u <YOUR_KEY_ID>:<YOUR_KEY_SECRET> \
-X GET https://api.razorpay.com/v1/customers/cust_1Aa00000000002/tokens
```

```java Java theme={null}
RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

String customerId = "cust_1Aa00000000002";

List<Token> tokens = razorpay.customers.fetchTokens(customerId);
```

```php PHP theme={null}
$api = new Api($key_id, $secret);

$api->customer->fetch($customerId)->tokens()->all();
```

```javascript Node.js theme={null}
var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

instance.customers.fetchTokens(customerId)
```

```python Python theme={null}
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))

client.token.all(customerId)
```

```ruby Ruby theme={null}
require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')

customerId = "cust_1Aa00000000004"

Razorpay::Customer.fetch(customerId).fetchTokens
```

```go Go theme={null}
import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

body, err := client.Token.All("<customerId>", nil, nil)
```

```csharp .NET theme={null}
RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

string customerId = "cust_1Aa00000000001";

List<Token> token = client.Customer.Fetch(customerId).Tokens();
```

```json Response theme={null}
{
  "entity": "collection",
  "count": 1,
  "items": [
    {
      "id": "token_FHfAzGzREc1ug6",
      "entity": "token",
      "token": "9KHtest0000001",
      "bank": null,
      "wallet": null,
      "method": "upi",
      "vpa": {
        "username": "gaurav.kumar",
        "handle": "upi",
        "name": null
      },
      "recurring": true,
      "recurring_details": {
        "status": "confirmed",
        "failure_reason": null
      },
      "auth_type": null,
      "mrn": null,
      "used_at": 1595447490,
      "created_at": 1595447490,
      "start_time": 1595447455,
      "dcc_enabled": false
    }
  ]
}
```

> [!NOTE]
>
> **Handy Tips**
>
> The `recurring_details.status` field in the response indicates the current token state. Use this to check if the token is `confirmed` (active), `paused`, `cancelled` or in any other state before attempting a subsequent debit.

### Path Parameter

**id** `string` *required*

The unique identifier of the customer for whom tokens are to be retrieved. For example, `cust_1Aa00000000002`.

## 2.5. Fetch Token by Token ID and Customer ID

Use this API to fetch token details using `token_id` and `customer_id` as path parameters.

`GET /v1/customers/:customer_id/tokens/:token_id`

```bash Request theme={null}
curl -u <YOUR_KEY_ID>:<YOUR_KEY_SECRET> \
-X GET https://api.razorpay.com/v1/customers/cust_1Aa00000000002/tokens/token_1Aa00000000001
```

```json Response theme={null}
{
  "id": "token_FHfAzGzREc1ug6",
  "entity": "token",
  "token": "9KHtest0000001",
  "bank": null,
  "wallet": null,
  "method": "upi",
  "vpa": {
    "username": "gaurav.kumar",
    "handle": "upi",
    "name": null
  },
  "recurring": true,
  "recurring_details": {
    "status": "confirmed",
    "failure_reason": null
  },
  "auth_type": null,
  "mrn": null,
  "used_at": 1595447490,
  "created_at": 1595447490,
  "start_time": 1595447455,
  "dcc_enabled": false,
  "max_amount": 500000,
  "expired_at": 1893456000
}
```

> [accordion] Path Parameters
>
> **customer\_id** `string` *required*
>
> The unique identifier of the customer with whom the token is linked. For example, `cust_1Aa00000000002`.
>
> **token\_id** `string` *required*
>
> The unique identifier of the token to be fetched. For example, `token_1Aa00000000001`.

> [accordion] Response Parameters
>
> **id** `string`
>
> The unique identifier of the token. For example, `token_FHfAzGzREc1ug6`.
>
> **entity** `string`
>
> The name of the entity. Here, it is `token`.
>
> **token** `string`
>
> The token value used to identify the mandate.
>
> **bank** `string`
>
> The bank associated with the token. Returns `null` for UPI tokens.
>
> **wallet** `string`
>
> The wallet associated with the token. Returns `null` for UPI tokens.
>
> **method** `string`
>
> The payment method associated with the token. Here, it is `upi`.
>
> **vpa** `object`
>
> Details of the customer's UPI VPA linked to the token.
>
> **vpa.username** `string`
>
> The username part of the customer's UPI ID.
>
> **vpa.handle** `string`
>
> The handle (bank or PSP) part of the customer's UPI ID. For example, `upi`.
>
> **vpa.name** `string`
>
> The account holder's name as registered with the bank. Returns `null` if not available.
>
> **recurring** `boolean`
>
> Indicates whether the token is enabled for recurring payments. Possible values: `true`, `false`.
>
> **recurring\_details** `object`
>
> Details of the recurring mandate associated with the token.
>
> **recurring\_details.status** `string`
>
> The status of the recurring mandate. For example, `confirmed`.
>
> **recurring\_details.failure\_reason** `string`
>
> The reason for mandate failure, if applicable. Returns `null` if there is no failure.
>
> **auth\_type** `string`
>
> The authentication type used. Returns `null` if not applicable.
>
> **mrn** `string`
>
> The mandate reference number. Returns `null` if not yet assigned.
>
> **used\_at** `integer`
>
> Unix timestamp at which the token was last used. Returns `null` if unused.
>
> **created\_at** `integer`
>
> Unix timestamp at which the token was created.
>
> **start\_time** `integer`
>
> Unix timestamp at which the mandate validity begins.
>
> **dcc\_enabled** `boolean`
>
> Indicates whether Dynamic Currency Conversion (DCC) is enabled.
>
> **max\_amount** `integer`
>
> The maximum amount that can be debited per transaction, in currency subunits.
>
> **expired\_at** `integer`
>
> Unix timestamp at which the token expires.

## 2.6. Cancel Token

You can cancel tokens that are in the `initiated`, `confirmed` or `paused` state. You can also retry a cancellation for a token that is in the `cancellation_initiated` state. Razorpay does not perform any additional validation checks before forwarding the cancellation request to NPCI.

The interim `cancellation_initiated` status is returned when the cancellation request is acknowledged but a successful callback from the downstream partners is not yet received. When the gateway returns a callback confirming the cancellation, the status updates to `cancelled` and the `token.cancelled` webhook is triggered. Wait for the `token.cancelled` webhook before suspending or terminating subscription services, or applying any late payment fees to customers. Use the following endpoint to cancel a token. This initiates the cancellation of the mandate from NPCI.

`PUT /customers/:customer_id/tokens/:token_id/cancel`

```bash Request theme={null}
curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X PUT https://api.razorpay.com/v1/customers/cust_1Aa00000000002/tokens/token_1Aa00000000001/cancel
```

```json Response theme={null}
{
      "status": "cancellation_initiated"
}
```

> [accordion] Path Parameters
>
> **customer\_id** `string` *required*
>
> The unique identifier of the customer with whom the token is linked. For example, `cust_1Aa00000000002`.
>
> **token\_id** `string` *required*
>
> The unique identifier of the token that is to be cancelled. For example, `token_1Aa00000000001`.

> [accordion] Error Response Parameters
>
> Given below is a list of possible errors you may face while cancelling a token.
>
> > [accordion] token\_not\_recurring
> >
> > * **Description**: The token provided is not a recurring/autopay token and is not eligible for cancellation via this API.
> > * **Next Steps**: Please ensure you are passing a valid UPI Autopay recurring token. Non-recurring tokens cannot be cancelled using this API.
>
> > [accordion] invalid\_mandate\_state
> >
> > * **Description**: The UPI mandate linked to this token is not in a cancellable state. The mandate may already be revoked or failed.
> > * **Next Steps**: Please check the current status of the mandate before attempting cancellation. Cancellation is only allowed when the mandate is in confirmed or active state.
>
> > [accordion] token\_customer\_mismatch
> >
> > * **Description**: The token provided does not belong to the authenticated customer. Cross-customer token access is not permitted.
> > * **Next Steps**: Please verify that the `token_id` belongs to the customer in context and retry with the correct token.
>
> > [accordion] token\_merchant\_mismatch
> >
> > * **Description**: The token provided was not created under your merchant account. Cross-merchant token access is not permitted.
> > * **Next Steps**: Please ensure you are using tokens created under your own merchant account and retry with the correct `token_id`.
>
> > [accordion] concurrent\_request\_in\_progress
> >
> > * **Description**: A cancellation or update operation is already in progress for this token. Simultaneous requests on the same token are not allowed.
> > * **Next Steps**: Please wait at least 60 seconds before retrying the cancellation request. Avoid sending duplicate or parallel cancel requests for the same token.

## 2.7. Delete Tokens

Deleting a token removes it from Razorpay's database. The deleted token will not appear on the Dashboard or when all tokens are fetched. However, it does not cancel the mandate. If you wish to delete the mandate with Razorpay, you must first cancel it using the [Cancel Token API](#2-6-cancel-token).

The following endpoint deletes a token.

`DELETE /customers/:customer_id/tokens/:token_id`

```bash Curl theme={null}
curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X DELETE https://api.razorpay.com/v1/customers/cust_1Aa00000000002/tokens/token_1Aa00000000001
```

```java Java theme={null}
RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

String customerId = "cust_1Aa00000000002";

String tokenId = "token_1Aa00000000001";

Customer customer = razorpay.customers.deleteToken(customerId, tokenId);
```

```php PHP theme={null}
$api = new Api($key_id, $secret);

$api->customer->fetch($customerId)->tokens()->delete($tokenId);
```

```javascript Node.js theme={null}
var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

instance.customers.deleteToken(customerId, tokenId)
```

```python Python theme={null}
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))

client.token.delete(customerId, tokenId)
```

```ruby Ruby theme={null}
require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')

customerId = "cust_1Aa00000000004"

tokenId = "token_Hxe0skTXLeg9pF"

Razorpay::Customer.fetch(customerId).deleteToken(tokenId)
```

```go Go theme={null}
import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

body, err := client.Token.Delete("<customerId>", "<tokenId>", nil, nil)
```

```csharp .NET theme={null}
RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

string customerId = "cust_Z6t7VFTb9xHeOs";

string tokenId = "token_1Aa00000000001";

Customer customer = client.Customer.Fetch(customerId).DeleteToken(tokenId);
```

```json Response theme={null}
{
    "deleted": true
}
```

> [accordion] Path Parameters
>
> **customer\_id** `string` *required*
>
> The unique identifier of the customer with whom the token is linked. For example, `cust_1Aa00000000002`.
>
> **token\_id** `string` *required*
>
> The unique identifier of the token that is to be deleted. For example, `token_1Aa00000000001`.

> [accordion] Response Parameters
>
> **deleted** `boolean`
>
> Indicates whether the token is deleted. Possible values:
>
> * `true`: The token is deleted successfully.
> * `false`: The token was not deleted.
