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

# Clear CVV

> Immediately delete the CVV stored on a token.

Immediately removes the CVV from a token. The card data itself is not affected.

<Card title="CVV Retention Policy Guide" icon="book" href="/capture-cards/cvv-retention-policy">
  Control how long CVV data is retained and who can use it
</Card>

## Error Responses

| Code  | HTTP Status | Condition                                                       |
| ----- | ----------- | --------------------------------------------------------------- |
| -1003 | 401         | User is not the owner of this token                             |
| -125  | 400         | Card not found (when `postponeUntilDate` is provided)           |
| -168  | 409         | Card has no CVV to clear (when `postponeUntilDate` is provided) |
| -179  | 400         | Failed to update CVV retention date                             |
| -150  | 500         | Could not clear CVV (immediate clear operation)                 |

## Parameter Constraints

| Parameter         | Type     | Required | Constraints                                                                                           |
| ----------------- | -------- | -------- | ----------------------------------------------------------------------------------------------------- |
| postponeUntilDate | DateTime | No       | Optional. When provided, defers CVV clearing until the specified date instead of clearing immediately |
| Auth              | string   | Yes      | Basic, ApiKey, AccessToken, or SessionToken                                                           |

## Parameters

### Headers

<ParamField header="Authorization" type="string" required>
  Your API key prefixed with `APIKEY`. Example: `APIKEY your-api-key`. For server-to-server calls.
</ParamField>

<Accordion title="Alternative: Browser-Side Authentication">
  This endpoint also accepts token-based authentication via query parameters:

  | Method                         | Details                                                                                                             |
  | ------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
  | **Access Token** (recommended) | `accessToken` query param. [How to generate](/getting-started/authentication#access-token).                         |
  | **Session Token**              | `sessionToken` query param. [How to generate](/api-reference/general/start-temporary-session). Valid for 5 minutes. |

  If multiple methods are provided, precedence: Session Token > Access Token > API Key.
</Accordion>

### Path Parameters

<ParamField path="cardToken" type="string" required>
  The token ID as returned by one of the tokenization methods.
</ParamField>

<RequestExample>
  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/clearcvv',
    {
      method: 'POST',
      headers: {
        'Authorization': 'APIKEY your-api-key'
      }
    }
  );

  console.log(response.status);
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/op/clearcvv',
      headers={'Authorization': 'APIKEY your-api-key'}
  )

  print(response.status_code)
  ```
</RequestExample>

## Response

**200** - CVV cleared. Empty response body.

<ResponseExample>
  ```text 200 theme={null}
  Empty response body. CVV cleared successfully.
  ```

  ```json 401 theme={null}
  {
      "code": -1003,
      "message": "Not authorized to access this resource",
      "moreInfo": "Bad or missing authorization data, expected APIKEY or Temp Session or HTTP Basic or One-Time Accesss Token",
      "errorList": null
  }
  ```
</ResponseExample>