信用卡 CVV 蒐集預先建構元件會擷取三或四位數的 CVV (信用卡驗證碼) 碼。
限制
除了常見的預先建構元件限制外，這個預先建構元件還有下列限制：
- 這個元件不包含付款閘道整合。
- CVV 長度必須為 3 或 4 位數。
其他功能
這個預先建構的元件提供下列額外功能：
建議的代理程式設定
啟用 DTMF，讓使用者透過電話鍵盤輸入數值。
對話方塊範例
下列範例對話方塊展示了這個預先建構元件處理的常見情境。範例對話會示範透過電話呼叫元件時的行為，這會觸發預設歡迎意圖，並在對話開始時提供第一個代理程式回應。
有效的 CVV
使用者提供三到四位數的 CVV，且元件接受該值。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入卡片上的 3 或 4 位數信用卡驗證碼。 | |
| 3434 | |
| 你說安全碼是 3434，對嗎？ | |
| 是 | |
| 很好，我已收集完 CVV。 |
重試
使用者在第三次嘗試時提供三到四位數的 CVV，且元件接受該 CVV。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入卡片上的 3 或 4 位數信用卡驗證碼。 | |
| 45 | |
| 我聽到 45，但這不是有效的 3 或 4 位數信用卡驗證碼。 請說出或輸入卡片上的 3 或 4 位數信用卡驗證碼。 |
|
| 34 | |
| 我聽到「34」，但這不是有效的 3 或 4 位數信用卡驗證碼。 請說出或輸入卡片上的 3 或 4 位數信用卡驗證碼。 |
|
| 3434 | |
| 你說安全碼是 3434，對嗎？ | |
| 是 | |
| 太好了，我已收集完 CVV。 |
無法辨識的輸入內容
如果使用者提供無法辨識的輸入內容三次，元件就會結束流程。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 請說出或輸入卡片上的 3 或 4 位數信用卡驗證碼。 | |
| 沒關係 | |
| 抱歉，我聽不懂，請再次說出或輸入卡片上的 3 或 4 位數信用卡驗證碼。 | |
| 沒關係 | |
| 抱歉，我還是沒聽清楚。請務必使用語音或鍵盤輸入卡片上的 3 或 4 位數 CVV 碼。 | |
| 沒關係 | |
| 抱歉，我不太瞭解你的意思。 |
命名慣例
這個預先建構的元件採用下列命名慣例：
| 功能 | 格式 | 範例 |
|---|---|---|
| Flow | [元件名稱] | CVV Collection |
| 元件專屬意圖 | prebuiltcomponents[componentname][intent_name] | prebuilt_components_cvv_collect_cvv |
| 參數 | [param_name] | cvv_code |
輸出參數
輸出參數是工作階段參數，在結束元件後仍會保持啟用狀態。這些參數包含元件收集的重要資訊。這個預先建構的元件會提供下列輸出參數的值：
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| cvv_collection_cvv | 這個參數會傳回元件擷取的 CVV | 字串 |
基本設定
如要設定這個預先建構的元件，請按照下列步驟操作：
完成
代理程式現在應已設定完成，可以開始測試。