付款預建元件會驗證使用者身分，並允許使用者付款。這個元件使用自訂版本的驗證預建元件，驗證帳戶持有人和持卡人。這個元件也會使用姓名收集、信用卡到期日收集和信用卡 CVV 收集預建元件，收集付款所需的資訊。
付款方式
這個元件支援信用卡帳單和受益人帳戶的付款。如果是信用卡帳單，使用者可以選擇支付最低應繳金額、總金額或自訂金額。使用者可以透過銀行帳戶、簽帳金融卡、信用卡或行動支付付款。
| 付款方式 | 可用的付款方式 | 可用的付款金額 |
|---|---|---|
| 信用卡帳單 | 銀行帳戶、簽帳金融卡、行動支付 | 最低、總計、自訂金額 |
| 受款人帳戶 | 銀行帳戶、信用卡、簽帳金融卡、行動支付 | 自訂金額 |
限制
除了常見的預建元件限制外，這項預建元件還有下列限制：
- 這個元件不會加密任何資料。
對話範例
下列對話範例說明這項預建元件處理的常見情境。範例對話會示範透過電話呼叫元件時的行為，這會觸發預設歡迎意圖，並在對話開始時觸發第一個代理回覆。
受款人帳戶付款
服務專員發現使用者先前未經驗證，因此會收集資訊，確認使用者是否為已註冊的使用者。使用者表示想付款至收款人帳戶，服務專員則收集必要資訊 (包括收款人姓名)，並確認帳號。最後，使用者選擇使用簽帳金融卡付款，因此代理會收集簽帳金融卡卡號、到期日、CVV，並確認付款。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 代理使用驗證預先建構元件驗證使用者 | |
| 謝謝，您已成功通過驗證。 | |
| 您想支付已登記的信用卡帳單，還是付款至現有的收款人帳戶？ | |
| 受益人 | |
| 代理使用名稱收集預建元件收集受益人姓名 | |
| 謝謝，我們已收集到受益人姓名。 好的，根據我們的記錄，我們有末 4 碼為 7821 的帳號。請說「是」來確認帳號。 |
|
| 是 | |
| 請確認要支付的金額。舉例來說，如果你想支付 $100.30 美元，請說「100 point 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 | |
| 好的，我們正在付款，請稍候。 簽帳金融卡已達上限，因此付款失敗。要改用其他付款方式重試嗎？ |
|
| 是 | |
| 你想透過銀行帳戶、簽帳金融卡或行動支付付款嗎？ | |
| 行動裝置 | |
| 好的，我們正在將付款連結傳送至你註冊的手機號碼。這項操作會在幾秒內完成。如果已收到，請說「是」來確認。 | |
| 是 | |
| 太好了，現在你可以開啟連結，繼續付款。 |
命名慣例
這個預建元件採用下列命名慣例：
| 功能 | 格式 | 範例 |
|---|---|---|
| Flow | [Component Name] | 付款 |
| 元件專屬意圖 | 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 | 指定 payment_status_code process_payment Webhook 傳回的欄位值，表示付款成功。這個值的預設值為 "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」(建構) 分頁標籤。
- 在「Flows」(流程) 部分，點選匯入的元件。
- 按一下「Pages」部分中的「Start Page」。
- 在「Start Page」中，點選「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，根據使用者註冊的電話號碼和提供的帳號後四碼，驗證帳戶是否存在。如果帳戶存在，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 網址」欄位中的網址，替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體，為 Webhook 建立適當的要求格式。
- 查看並更新回應設定，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要查看及更新「驗證」設定。
- 按一下「儲存」。
使用者卡片詳細資料
元件會使用 prebuilt_components_make_a_payment:user_card_details Webhook，取得已註冊的使用者的簽帳金融卡和信用卡詳細資料。
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 Webhook。
- 將 Dialogflow CX「Webhook 網址」欄位中的網址，替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體，為 Webhook 建立適當的要求格式。
- 查看並更新回應設定，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要查看及更新「驗證」設定。
- 按一下「儲存」。
驗證受款人姓名
元件會使用 prebuilt_components_make_a_payment:verify_beneficiary_name Webhook，驗證使用者提供的名稱是否有對應的收款人帳戶。
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 網址」欄位中的網址，替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體，為 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 網址」欄位中的網址，替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體，為 Webhook 建立適當的要求格式。
- 查看並更新回應設定，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要查看及更新「驗證」設定。
- 按一下「儲存」。
驗證信用卡號碼
元件會使用 prebuilt_components_make_a_payment:verify_credit_card_number Webhook，驗證提供的卡號是否已註冊到使用者帳戶。
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 網址」欄位中的網址，替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體，為 Webhook 建立適當的要求格式。
- 查看並更新回應設定，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要查看及更新「驗證」設定。
- 按一下「儲存」。
驗證信用卡資料
元件會使用 prebuilt_components_make_a_payment:verify_credit_card_details Webhook，驗證使用者提供的信用卡詳細資料 (包括到期日和 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 Webhook。
- 將 Dialogflow CX「Webhook 網址」欄位中的網址，替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體，為 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 Webhook。
- 將 Dialogflow CX「Webhook 網址」欄位中的網址，替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體，為 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 網址」欄位中的網址，替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體，為 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 Webhook。
- 將 Dialogflow CX「Webhook 網址」欄位中的網址，替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體，為 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 Webhook。
- 將 Dialogflow CX「Webhook 網址」欄位中的網址，替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體，為 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 網址」欄位中的網址，替換成要整合的服務端點。在下拉式選單中選取適當的「Method」。
- 查看並更新要求主體，為 Webhook 建立適當的要求格式。
- 查看並更新回應設定，從 Webhook 的回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
- 視需要查看及更新「驗證」設定。
- 按一下「儲存」。
完成
代理和 Webhook 應已設定完成，可以開始測試。