# CVVElement

> CVV payment element, used to collect the CVV (Card Verification Value) security code entered by the buyer. CVV is the 3-digit or 4-digit number on the back of a credit card/debit card, used to verify the cardholder's identity.

CVV payment element, used to collect the CVV (Card Verification Value) security code entered by the buyer. CVV is the 3-digit or 4-digit number on the back of a credit card/debit card, used to verify the cardholder's identity.

> **Note**: CVVElement is only responsible for rendering and collecting the CVV input box. To actually initiate payment, you need to call [`antom.confirmPayment()`](https://docs.antom.com/ac/sdks/web_antom-confirmPayment.md) and pass the `CVVElement` instance as the _elements_ parameter; if _elements_ is not passed, the SDK will initiate payment in UI-less mode and will not collect CVV.

## **Method signature**

When calling this method, please use the following standard method signature format.

#### Tab: JavaScript

```javascript
antom.createElement('CVV', options)
```

#### Tab: TypeScript

```typescript
antom.createElement(elementType: 'CVV', options?: CVVAppConfig): CVVElement
```

## Parameters

| **Parameter** | **Data type** | **Required** | **Description** |
| --- | --- | --- | --- |
| _elementType_ | String | Yes | Element type. In this scenario, pass in `CVV` to collect CVV. |
| [_options_](#3twpC) | Object | No | A configuration object used to set the appearance theme and multilingual environment of components. |

### _options_

| **Parameter** | **Data type** | **Required** | **Description** |
| --- | --- | --- | --- |
| _locale_ | String | No | Multilingual configuration. > **Note**: If the _locale_ parameter is set in the [`loadAntom()`](https://docs.antom.com/ac/sdks/web_loadAntom.md) method, the _locale_ value in the [`antom.createElement()`](https://docs.antom.com/ac/sdks/web_antom-createElement.md) method takes precedence. Valid values are: - `en_US`: Default value. English - `pt_BR`: Portuguese (Brazil) - `pt_PT`: Portuguese - `es_ES`: Spanish - `ko_KR`: Korean - `zh_CN`: Simplified Chinese - `zh_HK`: Traditional Chinese - `ms_MY`: Malay - `in_ID`: Indonesian - `th_TH`: Thai - `vi_VN`: Vietnamese - `tl_PH`: Filipino - `it_IT`: Italian - `de_DE`: German - `fr_FR`: French - `nl_NL`: Dutch - `ja_JP`: Japanese - `ro`: Romanian - `pl_PL`: Polish - `ar_SA`: Arabic - `tr_TR`: Turkish - `hi_IN`: Hindi |
| _appearance_ | Object | No | Used for custom appearance configuration. For more information, refer to [Appearance customization](https://docs.antom.com/ac/cashierpay/appearance.md). It contains the following parameters: - _theme_: Theme color. - _variables_: Override underlying CSS custom properties using CSS design tokens (e.g., `color-primary`) to implement theme customization. |

## Return value

This method returns a CVVElement instance object, providing methods for mounting, unmounting, destroying, and registering event listeners:

| **Method name** | **Description** |
| --- | --- |
| [`element.on()`](https://docs.antom.com/ac/sdks/web_element-on.md) | Register event listeners for the Element instance. |
| [`element.mount()`](https://docs.antom.com/ac/sdks/web_element-mount.md) | Used to mount the Element to the DOM. |
| [`element.destroy()`](https://docs.antom.com/ac/sdks/web_element-destroy.md) | Destroy the current Element (cannot be mounted again). |
| [`element.unmount()`](https://docs.antom.com/ac/sdks/web_element-unmount.md) | Unmount the current Element (can be mounted again). |