「付款」預先建構元件會驗證使用者身分，並允許使用者付款。這個元件使用自訂版本的驗證預先建構元件，驗證帳戶持有人和持卡人。這個元件也會使用姓名收集、信用卡到期日收集和信用卡 CVV 收集預先建構的元件，收集付款所需的資訊。
付款方式
這個元件支援信用卡帳單和受益人帳戶的付款。 使用者可以選擇支付信用卡帳單的最低應付金額、總額或自訂金額。使用者可透過銀行帳戶、簽帳金融卡/信用卡或行動支付付款。
| 付款方式 | 可用的付款方式 | 可用的付款金額 |
|---|---|---|
| 信用卡帳單 | 銀行帳戶、簽帳金融卡、行動支付 | 最低金額、總金額、自訂金額 |
| 受款人帳戶 | 銀行帳戶、信用卡、簽帳金融卡、行動支付 | 自訂金額 |
限制
除了常見的預先建構元件限制外，這個預先建構元件還有下列限制：
- 這個元件不會加密任何資料。
對話方塊範例
下列範例對話方塊展示了這個預先建構元件處理的常見情境。範例對話會示範透過電話呼叫元件時的行為，這會觸發預設歡迎意圖，並在對話開始時提供第一個代理程式回應。
受款人帳戶付款
服務專員會判斷使用者先前未通過驗證，並收集資訊來確認使用者是否為註冊使用者。使用者表示要付款至受益人帳戶，服務專員會收集必要資訊 (包括受益人姓名)，並確認帳號。最後，使用者選擇使用簽帳金融卡付款，因此服務專員會收集簽帳金融卡號碼、到期日、信用卡驗證碼，並確認付款。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 代理程式使用驗證預先建構的元件驗證使用者 | |
| 謝謝，您已成功完成驗證。 | |
| 你要支付已註冊的信用卡帳單，還是付款給現有的收款人帳戶？ | |
| 受益人 | |
| 代理程式使用名稱收集預先建構的元件收集受益人姓名 | |
| 謝謝，我們已收集受款人姓名。 好的，根據我們的記錄，帳號末四碼為 7821。請說「是」確認帳號。 |
|
| 是 | |
| 請確認要支付的金額，舉例來說，如要支付 $100.30 美元，請說「100 點 30」。 | |
| 50 美元 | |
| 你想透過銀行帳戶、簽帳金融卡、信用卡或行動支付付款嗎？ | |
| 扣款 | |
| 請提供你所指簽帳金融卡號的末 4 碼。 | |
| 1234 | |
| 我們取得的簽帳卡號碼末四碼為 1234，是否正確？ | |
| 沒錯 | |
| 服務專員使用信用卡到期日收集預建元件收集簽帳金融卡到期日 | |
| 很好，我們已收集完簽帳金融卡的到期日。 | |
| 服務專員使用信用卡 CVV 碼收集預先建構的元件，收集簽帳金融卡 CVV 碼 | |
| 很好，我們已完成收集 CVV。 | |
| 好的，我們將使用末四碼為 1234 的簽帳金融卡，向 Jane 支付 $50 美元。確定要執行這項操作嗎？ | |
| 是 | |
| 我們會傳送驗證碼給你，你偏好透過電話還是電子郵件接收驗證碼？ | |
| 請傳送電子郵件 | |
| 我們已將驗證碼傳送至您註冊的電子郵件地址 john.doe@google.com。請稍候片刻。請確認代碼。 | |
| 123456 | |
| 好的，我們正在付款，請稍候片刻。 已成功將款項匯入收款人帳戶。 |
支付信用卡帳單
服務專員會判斷使用者先前未通過驗證，並收集資訊來確認使用者是否為註冊使用者。使用者表示想透過銀行帳戶支付信用卡帳單款項。服務專員會確認付款金額和付款方式詳細資料，然後完成付款。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 代理程式使用驗證預先建構的元件驗證使用者 | |
| 謝謝，您已成功完成驗證。 | |
| 你要支付已註冊的信用卡帳單，還是付款給現有的收款人帳戶？ | |
| 信用卡帳單 | |
| 請提供你所指信用卡號碼的末 4 碼。 | |
| 4321 | |
| 我們收到的信用卡號末四碼為 4321，是否正確？ | |
| 是 | |
| 您的應付總額為 $300 美元，最低付款金額為 $20 美元。你希望支付總金額、最低金額還是其他金額？ | |
| 總金額 | |
| 要透過銀行帳戶、簽帳金融卡或行動支付付款嗎？ | |
| 儲蓄帳戶 | |
| 我們發現有 2 個帳戶與您的電話號碼相關聯。請提供你所指帳戶的末 4 碼。 | |
| 1001 | |
| 我們取得的帳號末四碼為 1001，是否正確？ | |
| 是 | |
| 好的，我們將透過帳號末碼 1001，支付信用卡帳單末碼 4321 的 $300 元。確定要執行這項操作嗎？ | |
| 是 | |
| 我們會傳送驗證碼給你，你偏好透過電話還是電子郵件接收驗證碼？ | |
| 傳送到我的電子郵件地址 | |
| 我們已將驗證碼傳送至您註冊的電子郵件地址 john.doe@google.com。請稍候片刻。請確認代碼。 | |
| 123456 | |
| 好的，我們正在付款，請稍候片刻。 已成功透過信用卡付款。 |
餘額或額度不足
服務專員會判斷使用者先前未通過驗證，並收集資訊來確認使用者是否為註冊使用者。使用者嘗試透過銀行帳戶和簽帳金融卡支付信用卡帳單，但由於資金不足或超出限額，兩筆款項都遭拒。最後，使用者選擇透過行動裝置付款，服務專員會傳送連結給使用者，讓他們透過行動裝置完成付款。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 代理程式使用驗證預先建構的元件驗證使用者 | |
| 謝謝，您已成功完成驗證。 | |
| 你要支付已註冊的信用卡帳單，還是付款給現有的收款人帳戶？ | |
| 信用卡 | |
| 請提供你所指信用卡號碼的末 4 碼。 | |
| 4321 | |
| 我們收到的信用卡號末四碼為 4321，是否正確？ | |
| 是 | |
| 您的應付總額為 $300 美元，最低付款金額為 $20 美元。你希望支付總金額、最低金額還是其他金額？ | |
| 總金額 | |
| 要透過銀行帳戶、簽帳金融卡或行動支付付款嗎？ | |
| 存款 | |
| 我們發現有 2 個帳戶與您的電話號碼相關聯。請提供你所指帳戶的末 4 碼。 | |
| 1002 | |
| 我們收到的帳號末四碼為 1002，是否正確？ | |
| 是 | |
| 好的，我們將透過帳號末碼 1002 的帳戶，支付末碼 4321 的信用卡帳單 $300 美元。確定要執行這項操作嗎？ | |
| 是 | |
| 我們會傳送驗證碼給你，你偏好透過電話還是電子郵件接收驗證碼？ | |
| 電子郵件 | |
| 我們已將驗證碼傳送至您註冊的電子郵件地址 john.doe@google.com。請稍候片刻。請確認代碼。 | |
| 123456 | |
| 好的，我們正在付款，請稍候片刻。 由於帳戶餘額不足，付款失敗。要改用其他付款方式重試付款嗎？ |
|
| 是 | |
| 要透過銀行帳戶、簽帳金融卡或行動支付付款嗎？ | |
| 簽帳金融卡 | |
| 請提供你所指簽帳金融卡號的末 4 碼。 | |
| 2345 | |
| 我們取得的簽帳卡號碼末四碼為 2345，是否正確？ | |
| 是 | |
| 服務專員使用信用卡到期日收集預先建構的元件收集簽帳金融卡到期日 | |
| 很好，我們已收集完簽帳金融卡的到期日。 | |
| 服務專員使用信用卡 CVV 碼收集預先建構的元件，收集簽帳金融卡 CVV 碼 | |
| 很好，我們已完成收集 CVV。 | |
| 好的，我們將使用末四碼為 2345 的簽帳金融卡，支付末四碼為 4321 的信用卡帳單 $300 美元。確定要執行這項操作嗎？ | |
| 是 | |
| 我們會傳送驗證碼給你，你偏好透過電話還是電子郵件接收驗證碼？ | |
| 電子郵件 | |
| 我們已將驗證碼傳送至您註冊的電子郵件地址 john.doe@google.com。請稍候片刻。請確認代碼。 | |
| 123456 | |
| 好的，我們正在付款，請稍候片刻。 由於扣款卡片超出限額，因此付款失敗。要改用其他付款方式重試付款嗎？ |
|
| 是 | |
| 要透過銀行帳戶、簽帳金融卡或行動支付付款嗎？ | |
| 行動裝置 | |
| 好的，我們正在將付款連結傳送至你註冊的手機號碼。這項作業可能需要幾秒鐘才能完成。如果已收到，請說「是」確認。 | |
| 是 | |
| 太好了，現在你可以開啟連結並繼續付款。 |
命名慣例
這個預先建構的元件採用下列命名慣例：
| 功能 | 格式 | 範例 |
|---|---|---|
| 心流狀態 | [元件名稱] | 付款 |
| 元件專屬意圖 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_make_a_payment_payment_type |
| 實體類型 | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_make_a_payment_payment_mode |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_make_a_payment:process_payment_credit_card |
輸入參數
輸入參數是用來設定元件特定行為的參數。流程中的一或多個條件會使用這些參數，判斷元件的行為。如要設定流程範圍參數，請按照下方說明，在元件的開始頁面進行設定。工作階段範圍的參數可透過呼叫流程設定，也可以在這個元件的開始頁面設定。
這個預先建構的元件接受下列輸入參數：
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.auth_level | (選用) 指出呼叫端的驗證層級。 | 整數 |
| $session.params.auth_level_req | 指出使用者存取交易記錄前所需的驗證等級。這個值是在 check auth level 頁面的頁面項目執行中，透過參數預設值設定。根據預設，這個值為 1。 |
整數 |
| $session.params.account_auth_enabled | 指出是否應根據「驗證類型」一文的說明，驗證使用者是否為帳戶持有人。這個值是在 check auth level 頁面的頁面項目執行中，透過參數預設值設定。根據預設，這個值為 true。 |
布林值 |
| $session.params.card_auth_enabled | 指出是否應根據「驗證類型」一文所述，驗證使用者是否為持卡人。這個值是在 check auth level 頁面的頁面項目執行中，透過參數預設值設定。根據預設，這個值為 false。 |
布林值 |
| $session.params.phone_number | (選用) 用於驗證的客戶註冊電話號碼。 | 字串 |
| $flow.payment_success_code | 指定 process_payment webhook 傳回的 payment_status_code 欄位值，指出付款成功。根據預設，這個值為 "200"。 |
字串 |
| $flow.insufficient_fund_code | 指定 process_payment webhook 傳回的 payment_status_code 欄位值，表示餘額不足，因此無法完成付款。根據預設，這個值為 "400"。 |
字串 |
| $flow.limit_exceed_code | 指定 process_payment Webhook 傳回的 payment_status_code 欄位值，指出因超出每日限額而無法完成付款。根據預設，這個值為 "401"。 |
字串 |
| $flow.max_retry_mop_counter | 指定使用者可變更付款方式的次數。預設值為 2。 |
整數 |
| $flow.max_retry_credit_card_payment | 指定使用信用卡付款時允許的重試次數。預設值為 3。 |
整數 |
| $flow.max_retry_mobile_payment_counter | 指定使用行動支付付款時允許的重試次數。預設值為 2。 |
整數 |
| $flow.max_retry_creditcard_count | 指定在收集有效信用卡號以進行付款時，允許的重試次數。預設值為 3。 |
整數 |
| $flow.max_retry_acc_number | 指定在收集有效帳戶詳細資料以進行付款時，允許的重試次數。預設值為 3。 |
整數 |
| $flow.max_retry_debit_card_details | 指定收集有效金融卡詳細資料以進行付款時，允許的重試次數。預設值為 3。 |
整數 |
| $flow.max_retry_credit_card_details | 指定在收集有效信用卡詳細資料以進行付款時，允許的重試次數。預設值為 3。 |
整數 |
| $flow.otp_length | 指定傳送給使用者的動態密碼長度。預設值為 6。 |
整數 |
| $flow.max_retry_otp_count | 指定向使用者收集有效一次性密碼 (OTP) 時允許的重試次數。預設值為 3。 |
整數 |
| $flow.max_waiting_room_counter | 指定使用者在收到行動支付連結時，可要求服務專員稍候的次數。預設值為 2。 |
整數 |
如要設定這個元件的輸入參數，請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「Build」(建構) 分頁標籤。
- 在「流程」部分中，按一下匯入的元件。
- 按一下「頁面」部分中的「開始頁面」。
- 在「開始頁面」中，按一下「true」路徑。
- 在「Route」視窗中，視需要編輯「Parameter Presets」值。
- 按一下「儲存」。
輸出參數
輸出參數是工作階段參數，在結束元件後仍會保持啟用狀態。這些參數包含元件收集的重要資訊。這個預先建構的元件會提供下列輸出參數的值：
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| auth_level | 指出呼叫端的驗證等級。 | 整數 |
| phone_number | 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。 | 字串 |
| transfer_reason | 如果流程未順利結束，這項參數會指出流程結束的原因。傳回的值為下列其中之一：agent：使用者在對話期間要求與真人服務專員通話。denial_of_information：使用者拒絕分享元件要求的資訊。max_no_input：對話達到無輸入事件的重試次數上限。請參閱無輸入內容的內建事件。max_no_match：對話已達無相符事件的重試次數上限。請參閱不相符的內建事件。webhook_error：發生 Webhook 錯誤。請參閱「webhook.error 內建事件」。webhook_not_found：無法連上 Webhook 網址。請參閱「webhook.error.not-found 內建事件」。 |
字串 |
基本設定
如要設定這個預先建構的元件，請按照下列步驟操作：
- 匯入預先建構的元件。
- 設定提供的彈性 Webhook，並使用描述外部服務的設定，請參閱下方的「Webhook 設定」。
設定 Webhook
如要使用這個元件，您必須設定內含的彈性 Webhook，從外部服務擷取所需資訊。
驗證
如果您先前未設定驗證所需的外部服務，則必須設定這些服務，才能為這個元件啟用使用者驗證。如需詳細操作說明，請參閱「驗證 Webhook 設定」。
驗證帳戶
這個元件會使用 prebuilt_components_account_services:validate_account 網路鉤子，根據使用者註冊的電話號碼和提供的帳號末四碼，驗證帳戶是否存在。如果帳戶存在，Webhook 也會傳回帳戶餘額。
API 要求參數
元件會提供下列參數，做為 API 要求的輸入內容。
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.phone_number | 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。 | 字串 |
| $session.params.last_four_digit_of_account_number | 使用者選取並確認用來付款的帳號末四碼。 | 字串 |
API 回應參數
系統會從 API 回應中擷取下列參數，供元件使用。
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| account_found | 指出使用者註冊帳戶是否具有所提供的末四碼。 | 布林值 |
| 餘額 | 帳戶目前的餘額 (如有)。 | 數字 |
如要為這個元件設定「驗證帳戶」Webhook，請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_account_services:validate_account Webhook。
- 將 Dialogflow CX「Webhook URL」欄位中的網址，換成要整合的服務端點。在下拉式選單中選取適當的「方法」。
- 查看並更新要求主體，為 Webhook 建立正確的要求格式。
- 查看並更新「回應設定」，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要檢查並更新「驗證」設定。
- 按一下「儲存」。
使用者卡片詳細資料
元件會使用 prebuilt_components_make_a_payment:user_card_details 網路鉤子，取得已註冊使用者簽帳卡和信用卡的詳細資料。
API 要求參數
元件會提供下列參數，做為 API 要求的輸入內容。
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.phone_number | 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。 | 字串 |
API 回應參數
系統會從 API 回應中擷取下列參數，供元件使用。
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| credit_card_count | 與登記電話號碼相關聯的信用卡數量。 | 整數 |
| last_four_digit_of_credit_card_number | 使用者信用卡號末四碼。如果顧客有多張信用卡，這個值為 null。 |
字串 |
| debit_card_count | 與登記電話號碼相關聯的簽帳卡數量。 | 整數 |
| last_four_digit_of_debit_card_number | 使用者的簽帳金融卡末四碼。如果顧客有多張簽帳卡，這個值為 null。 |
字串 |
如要為這個元件設定「使用者資訊卡詳細資料」Webhook，請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_make_a_payment:user_card_details 網路鉤回呼。
- 將 Dialogflow CX「Webhook URL」欄位中的網址，換成要整合的服務端點。在下拉式選單中選取適當的「方法」。
- 查看並更新要求主體，為 Webhook 建立正確的要求格式。
- 查看並更新「回應設定」，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要檢查並更新「驗證」設定。
- 按一下「儲存」。
驗證受益人姓名
元件會使用 prebuilt_components_make_a_payment:verify_beneficiary_name 網路鉤子，確認使用者提供的名稱是否已有受益人帳戶。
API 要求參數
元件會提供下列參數，做為 API 要求的輸入內容。
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.phone_number | 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。 | 字串 |
| $session.params.name_collection_first_name | 受益人的名字。 | 字串 |
| $session.params.name_collection_last_name | 受益人的姓氏。 | 字串 |
| $session.params.name_collection_middle_name | 受益人的中間名。 | 字串 |
API 回應參數
系統會從 API 回應中擷取下列參數，供元件使用。
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| beneficiary_account_number | 所提供受益人姓名的受益人帳號末四碼。如果系統找不到與所提供名稱相符的受益人帳戶，值為 null。 |
字串 |
如要為這個元件設定「驗證受益人姓名」Webhook，請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_make_a_payment:verify_beneficiary_name Webhook。
- 將 Dialogflow CX「Webhook URL」欄位中的網址，換成要整合的服務端點。在下拉式選單中選取適當的「方法」。
- 查看並更新要求主體，為 Webhook 建立正確的要求格式。
- 查看並更新「回應設定」，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要檢查並更新「驗證」設定。
- 按一下「儲存」。
取得應付金額
元件會使用 prebuilt_components_make_a_payment:get_due_amount webhook，取得使用者信用卡帳單的最低應付金額和總應付金額資訊。
API 要求參數
元件會提供下列參數，做為 API 要求的輸入內容。
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.phone_number | 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。 | 字串 |
| $flow.user_credit_card_number | 使用者信用卡號末四碼。 | 字串 |
API 回應參數
系統會從 API 回應中擷取下列參數，供元件使用。
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| minimum_amount | 指定信用卡帳單的最低應付金額。 | 數字 |
| total_amount | 指定信用卡帳單的應付總額。 | 數字 |
如要為這個元件設定「取得應付金額」Webhook，請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_make_a_payment:get_due_amount Webhook。
- 將 Dialogflow CX「Webhook URL」欄位中的網址，換成要整合的服務端點。在下拉式選單中選取適當的「方法」。
- 查看並更新要求主體，為 Webhook 建立正確的要求格式。
- 查看並更新「回應設定」，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要檢查並更新「驗證」設定。
- 按一下「儲存」。
驗證信用卡號碼
元件會使用 prebuilt_components_make_a_payment:verify_credit_card_number 網路鉤子，驗證提供的信用卡號碼是否已註冊至使用者帳戶。
API 要求參數
元件會提供下列參數，做為 API 要求的輸入內容。
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.phone_number | 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。 | 字串 |
| $flow.user_credit_card_number | 使用者信用卡號末四碼。 | 字串 |
API 回應參數
系統會從 API 回應中擷取下列參數，供元件使用。
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| card_found | 指出是否找到提供的信用卡。 | 布林值 |
如要為這個元件設定「驗證信用卡號碼」Webhook，請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_make_a_payment:verify_credit_card_number Webhook。
- 將 Dialogflow CX「Webhook URL」欄位中的網址，換成要整合的服務端點。在下拉式選單中選取適當的「方法」。
- 查看並更新要求主體，為 Webhook 建立正確的要求格式。
- 查看並更新「回應設定」，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要檢查並更新「驗證」設定。
- 按一下「儲存」。
驗證信用卡資料
這個元件會使用 prebuilt_components_make_a_payment:verify_credit_card_details 網路鉤子，驗證使用者提供的信用卡詳細資料 (包括到期日和 CVV) 是否有效。
API 要求參數
元件會提供下列參數，做為 API 要求的輸入內容。
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.phone_number | 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。 | 字串 |
| $flow.credit_card_number | 使用者信用卡號末四碼。 | 字串 |
| $flow.credit_card_exp_date | 使用者提供的特定信用卡到期日。 | { |
| $flow.credit_card_cvv_code | 使用者為指定信用卡提供的 CVV 碼。 | 字串 |
API 回應參數
系統會從 API 回應中擷取下列參數，供元件使用。
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| creditcard_verification_status | 指出提供的信用卡詳細資料是否已通過驗證。 | 布林值 |
如要為這個元件設定「驗證信用卡詳細資料」Webhook，請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_make_a_payment:verify_credit_card_details 網路鉤子。
- 將 Dialogflow CX「Webhook URL」欄位中的網址，換成要整合的服務端點。在下拉式選單中選取適當的「方法」。
- 查看並更新要求主體，為 Webhook 建立正確的要求格式。
- 查看並更新「回應設定」，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要檢查並更新「驗證」設定。
- 按一下「儲存」。
驗證簽帳金融卡資料
元件會使用 prebuilt_components_make_a_payment:verify_debit_card_details Webhook，驗證使用者提供的簽帳金融卡詳細資料 (包括有效日期和 CVV) 是否有效。
API 要求參數
元件會提供下列參數，做為 API 要求的輸入內容。
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.phone_number | 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。 | 字串 |
| $flow.debit_card_number | 使用者的簽帳金融卡末四碼。 | 字串 |
| $flow.debit_card_exp_date | 使用者為指定簽帳金融卡提供的到期日。 | { |
| $flow.debit_card_cvv_code | 使用者為指定簽帳金融卡提供的 CVV 碼。 | 字串 |
API 回應參數
系統會從 API 回應中擷取下列參數，供元件使用。
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| debitcard_verification_status | 指出提供的簽帳金融卡詳細資料是否已通過驗證。 | 布林值 |
如要為這個元件設定「驗證簽帳金融卡詳細資料」Webhook，請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_make_a_payment:verify_debit_card_details 網路鉤子。
- 將 Dialogflow CX「Webhook URL」欄位中的網址，換成要整合的服務端點。在下拉式選單中選取適當的「方法」。
- 查看並更新要求主體，為 Webhook 建立正確的要求格式。
- 查看並更新「回應設定」，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要檢查並更新「驗證」設定。
- 按一下「儲存」。
處理信用卡付款
元件會使用 prebuilt_components_make_a_payment:process_payment_credit_card webhook，透過提供的信用卡詳細資料處理付款。
API 要求參數
元件會提供下列參數，做為 API 要求的輸入內容。
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.phone_number | 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。 | 字串 |
| $flow.payee_number | 收款人帳號的末四碼。 | 字串 |
| $flow.payment_type | 付款的付款方式。有效值由 prebuilt_components_make_a_payment_payment_type 自訂實體定義。根據預設，這個元件支援 "beneficiary_pay" 和 "credit_card_pay"。 |
字串 |
| $flow.credit_card_number | 使用者信用卡號末四碼。 | 字串 |
| $flow.credit_card_exp_date | 使用者為指定信用卡提供的到期日。 | { |
| $flow.credit_card_cvv_code | 使用者為指定信用卡提供的 CVV 碼。 | 字串 |
| $flow.payment_amount | 使用者選擇支付的金額。 | 數字 |
API 回應參數
系統會從 API 回應中擷取下列參數，供元件使用。
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| payment_status_code | 指出付款是否成功。有效值由 $flow.payment_success_code、$flow.insufficient_fund_code 和 $flow.limit_exceed_code 可設定的輸入參數定義。 |
字串 |
如要為這個元件設定「處理信用卡付款」Webhook，請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_make_a_payment:process_payment_credit_card Webhook。
- 將 Dialogflow CX「Webhook URL」欄位中的網址，換成要整合的服務端點。在下拉式選單中選取適當的「方法」。
- 查看並更新要求主體，為 Webhook 建立正確的要求格式。
- 查看並更新「回應設定」，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要檢查並更新「驗證」設定。
- 按一下「儲存」。
處理簽帳金融卡付款
元件會使用 prebuilt_components_make_a_payment:process_payment_debit_card webhook，透過提供的簽帳金融卡詳細資料處理付款。
API 要求參數
元件會提供下列參數，做為 API 要求的輸入內容。
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.phone_number | 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。 | 字串 |
| $flow.payee_number | 收款人帳號的末四碼。 | 字串 |
| $flow.payment_type | 付款的付款方式。有效值由 prebuilt_components_make_a_payment_payment_type 自訂實體定義。根據預設，這個元件支援 "beneficiary_pay" 和 "credit_card_pay"。 |
字串 |
| $flow.debit_card_number | 使用者的簽帳金融卡末四碼。 | 字串 |
| $flow.debit_card_exp_date | 使用者為指定簽帳金融卡提供的到期日。 | { |
| $flow.debit_card_cvv_code | 使用者為指定簽帳金融卡提供的 CVV 碼。 | 字串 |
| $flow.payment_amount | 使用者選擇支付的金額。 | 數字 |
API 回應參數
系統會從 API 回應中擷取下列參數，供元件使用。
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| payment_status_code | 指出付款是否成功。有效值由 $flow.payment_success_code、$flow.insufficient_fund_code 和 $flow.limit_exceed_code 可設定的輸入參數定義。 |
字串 |
如要為這個元件設定「處理簽帳金融卡付款」Webhook，請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_make_a_payment:process_payment_debit_card 網路鉤子。
- 將 Dialogflow CX「Webhook URL」欄位中的網址，換成要整合的服務端點。在下拉式選單中選取適當的「方法」。
- 查看並更新要求主體，為 Webhook 建立正確的要求格式。
- 查看並更新「回應設定」，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要檢查並更新「驗證」設定。
- 按一下「儲存」。
處理帳戶付款
元件會使用 prebuilt_components_make_a_payment:process_payment_account Webhook，透過提供的帳戶詳細資料處理付款。
API 要求參數
元件會提供下列參數，做為 API 要求的輸入內容。
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.phone_number | 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。 | 字串 |
| $flow.payee_number | 收款人帳號的末四碼。 | 字串 |
| $flow.payment_type | 付款的付款方式。有效值由 prebuilt_components_make_a_payment_payment_type 自訂實體定義。根據預設，這個元件支援 "beneficiary_pay" 和 "credit_card_pay"。 |
字串 |
| $session.params.last_four_digit_of_account_number | 使用者帳戶的末四碼。 | 字串 |
| $flow.payment_amount | 使用者選擇支付的金額。 | 數字 |
API 回應參數
系統會從 API 回應中擷取下列參數，供元件使用。
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| payment_status_code | 指出付款是否成功。有效值由 $flow.payment_success_code、$flow.insufficient_fund_code 和 $flow.limit_exceed_code 可設定的輸入參數定義。 |
字串 |
如要設定這個元件的「處理帳戶付款」Webhook，請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_make_a_payment:process_payment_account 網頁掛鉤。
- 將 Dialogflow CX「Webhook URL」欄位中的網址，換成要整合的服務端點。在下拉式選單中選取適當的「方法」。
- 查看並更新要求主體，為 Webhook 建立正確的要求格式。
- 查看並更新「回應設定」，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要檢查並更新「驗證」設定。
- 按一下「儲存」。
處理行動支付
這個元件會使用 prebuilt_components_make_a_payment:process_payment_mobile Webhook，根據使用者選取的付款詳細資料產生並傳送行動支付連結。
API 要求參數
元件會提供下列參數，做為 API 要求的輸入內容。
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $session.params.phone_number | 使用者的當地電話號碼 (不含國家/地區代碼)，用於識別使用者。 | 字串 |
| $flow.payee_number | 收款人帳號的末四碼。 | 字串 |
| $flow.payment_type | 付款的付款方式。有效值由 prebuilt_components_make_a_payment_payment_type 自訂實體定義。根據預設，這個元件支援 "beneficiary_pay" 和 "credit_card_pay"。 |
字串 |
| $flow.payment_amount | 使用者選擇支付的金額。 | 數字 |
API 回應參數
系統會從 API 回應中擷取下列參數，供元件使用。
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| payment_link_generated | 指出系統是否已成功產生行動支付連結並傳送給使用者。 | 布林值 |
如要為這個元件設定「處理行動支付」Webhook，請展開查看操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「Webhooks」。
- 選取 prebuilt_components_make_a_payment:process_payment_mobile Webhook。
- 將 Dialogflow CX「Webhook URL」欄位中的網址，換成要整合的服務端點。在下拉式選單中選取適當的「方法」。
- 查看並更新要求主體，為 Webhook 建立正確的要求格式。
- 查看並更新「回應設定」，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要檢查並更新「驗證」設定。
- 按一下「儲存」。
完成
代理程式和 Webhook 現在應已設定完成，可供測試。