The credit card CVV collection
[prebuilt component](https://docs.cloud.google.com/dialogflow/cx/docs/concept/prebuilt-component.md.txt)
captures a three- or four-digit CVV (Card Verification Value) code.

## Limitations

In addition to the
[common prebuilt component limitations](https://docs.cloud.google.com/dialogflow/cx/docs/concept/prebuilt-component.md.txt#limits),
this prebuilt component has the following limitations:

- This component does not include payment gateway integration.
- This component does not accept CVVs shorter than three or longer than four digits.

## Additional features

This prebuilt component provides the following additional features:

- [Repeat](https://docs.cloud.google.com/dialogflow/cx/docs/concept/prebuilt-component.md.txt#repeat-functionality)
- [Waiting room](https://docs.cloud.google.com/dialogflow/cx/docs/concept/prebuilt-component.md.txt#waiting-room-functionality)
- [Playback](https://docs.cloud.google.com/dialogflow/cx/docs/concept/prebuilt-component.md.txt#playback-functionality)

## Recommended agent settings

[Enable DTMF](https://docs.cloud.google.com/dialogflow/cx/docs/concept/parameter.md.txt#dtmf) to let users input
numeric values using the telephone keypad.

## Sample dialogs

The sample dialogs show common scenarios that this prebuilt component handles.
They demonstrate behavior when the user calls the component using telephony,
which triggers the Default Welcome Intent and the first agent response at the
start of the conversation.

### Valid CVV

The user provides a three- to four-digit CVV, and the component accepts it.

| User Input | Agent Response |
|---|---|
|   | Say or enter the 3 or 4 digit CVV present on your card. |
| 3434 |   |
|   | You mentioned the CVV is 3434, is that correct? |
| yes |   |
|   | Great, I'm done with collecting the CVV. |

### Retries

The user provides a three- to four-digit CVV in the third attempt, and the
component accepts it.

| User Input | Agent Response |
|---|---|
|   | Say or enter the 3 or 4 digit CVV present on your card. |
| 45 |   |
|   | I heard 45, which isn't a valid 3 or 4 digit CVV code. Say or enter the 3 or 4 digit CVV present on your card. |
| 34 |   |
|   | I heard 34, which isn't a valid 3 or 4 digit CVV code. Say or enter the 3 or 4 digit CVV present on your card. |
| 3434 |   |
|   | You mentioned the CVV is 3434, is that correct? |
| yes |   |
|   | Great, I'm done with collecting the CVV. |

### Unrecognized input

The component ends the flow when the user provides unrecognized input three
times.

| User Input | Agent Response |
|---|---|
|   | Say or enter the 3 or 4 digit CVV present on your card. |
| It's fine |   |
|   | Sorry, I didn't get that. Can you say or enter the 3 or 4 digit CVV present on your card again? |
| It's fine |   |
|   | Hmm, I still wasn't able to get that. Make sure you're saying or using your keypad to enter the 3 or 4 digit CVV present on your card. |
| It's fine |   |
|   | Sorry, I'm having difficulty understanding your response. |

## Naming conventions

This prebuilt component uses the following naming conventions:

| Feature | Format | Example |
|---|---|---|
| Flow | \[Component Name\] | CVV Collection |
| Component Specific Intent | prebuilt*components* \[component*name\]*\[intent_name\] | prebuilt_components_cvv_collect_cvv |
| Parameter | \[param_name\] | cvv_code |

## Output parameters

Output parameters are session parameters that remain active after you exit the
component. These parameters contain important information that the component
collects.

This prebuilt component provides values for the following output parameters:

| Parameter Name | Description | Output Format |
|---|---|---|
| cvv_collection_cvv | This parameter returns the CVV captured by the component. | string |

## Basic setup

To set up this prebuilt component, you can
[import the prebuilt component](https://docs.cloud.google.com/dialogflow/cx/docs/concept/prebuilt-component.md.txt#import).

### Complete

The credit card CVV collection prebuilt component is now set up and ready to
test.