製作預先建構的付款元件

「付款」預先建構元件可驗證使用者，並允許他們付款。這個元件會使用自訂版本的驗證預先建構元件，驗證帳戶持有人和卡片持有人。元件也會使用姓名收集、信用卡到期日收集和信用卡 CVV 收集預先建構的元件，收集付款所需的資訊。

付款方式

這個元件支援信用卡帳單和受益者帳戶的付款。對於信用卡帳單，使用者可以選擇支付帳單的最低金額、總金額或自訂金額。使用者可以使用銀行帳戶、簽帳金融卡或信用卡，或是行動支付付款。

付款方式 可用的付款方式 可用的付款金額
信用卡帳單 銀行帳戶、簽帳金融卡、行動支付 最低金額、總金額、自訂金額
受款人帳戶 銀行帳戶、信用卡、簽帳金融卡、行動支付 自訂金額

限制

除了常見的預先建構元件限制外，這個預先建構元件還有以下限制：

  • 這個元件不會加密任何資料。

對話方塊範例

以下對話方塊範例說明這個預先建構元件處理的常見情境。以下對話方塊範例說明透過電話呼叫元件時的行為，這會在對話開始時觸發預設歡迎意圖和第一個服務專員回應。

受款人帳戶付款

服務專員會判斷使用者是否先前未經過驗證，並收集資訊，驗證使用者是否為註冊使用者。使用者表示要向受款帳戶付款，代理人會收集必要資訊，包括受款人姓名，並確認帳號。最後，使用者選擇使用簽帳金融卡付款，因此服務專員會收集簽帳金融卡號碼、到期日和 CVV，並確認付款。

使用者輸入內容 服務專員回覆
Agent 使用驗證預先建構的元件驗證使用者
謝謝，您已順利完成驗證。
您要支付註冊的信用卡帳單，還是要透過現有受款帳戶付款？
受益人
代理程式使用名稱收集預先建構的元件收集受益者名稱
謝謝，我們已收集到受款人姓名。

好的，根據我們的記錄，我們有結尾為 7821 的帳號。請說「是」，確認帳號。
是
請確認您要支付的金額。舉例來說，如果您想支付 $100.30 美元，請說「100 點 30」。
50 美元
你想使用銀行帳戶、簽帳金融卡、信用卡或行動支付付款嗎？
簽帳金融卡
能否告訴我們你所指的簽帳金融卡號碼末 4 碼？
1234
我們收到的簽帳金融卡號碼末四碼是 1234，對嗎？
沒錯
服務專員使用信用卡到期日收集預先建構的元件收集簽帳金融卡到期日
太好了，我們已收集到簽帳金融卡的到期日。
服務專員使用信用卡 CVV 收集預先建構元件收集簽帳金融卡 CVV 碼
太好了，我們已完成收集 CVV。
好的，我們要使用結尾為 1234 的簽帳金融卡號碼，向 Jane 支付 $50 美元。請確認這項操作。
是
我們會傳送驗證碼給你，以便繼續進行。你想透過電話還是電子郵件接收驗證碼？
請傳送電子郵件
我們已將驗證碼傳送至你註冊的電子郵件地址 john.doe@google.com。這可能需要幾秒鐘的時間。請確認代碼。
123456
好的，我們正在處理付款，請稍候。

我們已成功向收款人帳戶付款。

信用卡帳單付款

服務專員會判斷使用者是否先前未經過驗證，並收集資訊，驗證使用者是否為註冊使用者。使用者表示，他們想使用銀行帳戶支付信用卡帳單。服務專員確認付款金額和付款方式詳細資料，並完成付款。

使用者輸入內容 服務專員回應
Agent 使用驗證預先建構的元件驗證使用者
謝謝，您已順利完成驗證。
您要支付註冊的信用卡帳單，還是要透過現有受款帳戶付款？
信用卡帳單
能否告訴我們你所指的信用卡號碼末 4 碼？
4321
我們收到的信用卡號碼末四碼是 4321，對嗎？
是
應付總額為 $300 美元，最低付款金額為 $20 美元。你想支付總金額、最低金額，還是其他金額？
總金額
你想使用銀行帳戶、簽帳金融卡或行動支付付款嗎？
儲蓄帳戶
我們發現有 2 個帳戶與你的電話號碼相關聯。能否告訴我們你所指帳戶的末 4 碼？
1001
我們收到的帳號末四碼是 1001，對嗎？
是
好的，我們將為結尾為 4321 的信用卡帳單 (結尾為 1001 的帳號) 支付 $300 美元。請確認這項操作。
是
我們會傳送驗證碼給你，以便繼續進行。你想透過電話還是電子郵件接收驗證碼？
傳送到我的電子郵件地址
我們已將驗證碼傳送至你註冊的電子郵件地址 john.doe@google.com。這可能需要幾秒鐘的時間。請確認代碼。
123456
好的，我們正在處理付款，請稍候幾秒。

你的信用卡付款已成功。

帳戶餘額或額度不足

服務專員會判斷使用者是否先前未經過驗證，並收集資訊，驗證使用者是否為註冊使用者。使用者嘗試使用銀行帳戶和簽帳金融卡付款，但由於資金不足或超過限額，兩筆付款都遭拒。最後，使用者選擇透過行動裝置付款，服務專員會傳送連結，方便使用者透過行動裝置完成付款。

使用者輸入內容 服務專員回應
Agent 使用驗證預先建構的元件驗證使用者
謝謝，您已順利完成驗證。
您要支付註冊的信用卡帳單，還是要透過現有受款帳戶付款？
信用卡
能否告訴我們你所指的信用卡號碼末 4 碼？
4321
我們收到的信用卡號碼末四碼是 4321，對嗎？
是
應付總額為 $300 美元，最低付款金額為 $20 美元。你想支付總金額、最低金額，還是其他金額？
總金額
你想使用銀行帳戶、簽帳金融卡或行動支付付款嗎？
存款
我們發現有 2 個帳戶與你的電話號碼相關聯。能否告訴我們你所指帳戶的末 4 碼？
1002
我們取得的帳號末四碼是 1002，對嗎？
是
好的，我們將為結尾為 4321 的信用卡帳單 (結尾為 1002 的帳號) 支付 $300 美元。請確認這項操作。
是
我們會傳送驗證碼給你，以便繼續進行。你想透過電話還是電子郵件接收驗證碼？
電子郵件
我們已將驗證碼傳送至你註冊的電子郵件地址 john.doe@google.com。這可能需要幾秒鐘的時間。請確認代碼。
123456
好的，請稍候片刻，我們正在處理付款。

你的帳戶餘額不足，因此付款失敗。您是否要改用其他付款方式重試付款？
是
你想使用銀行帳戶、簽帳金融卡或行動支付付款嗎？
簽帳金融卡
能否告訴我們你所指的簽帳金融卡號碼末 4 碼？
2345
我們收到的簽帳金融卡號碼末四碼是 2345，對嗎？
是
服務專員使用信用卡到期日收集預先建構的元件收集簽帳金融卡到期日
太好了，我們已收集到簽帳金融卡的到期日。
服務專員使用信用卡 CVV 收集預先建構元件收集簽帳金融卡 CVV 碼
太好了，我們已完成收集 CVV。
好的，我們將為你的信用卡帳單 (結尾 4321) 和簽帳金融卡號碼 (結尾 2345) 支付 $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。 整數

如要設定此元件的輸入參數，請展開操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 專案。
  3. 選取所需的代理程式。
  4. 選取「Build」分頁標籤。
  5. 在「流程」部分中，按一下匯入的元件。
  6. 按一下「網頁」部分中的「首頁」。
  7. 按一下「Start」頁面中的「true」路徑。
  8. 在路徑視窗中，視需要編輯「參數預設值」值。
  9. 按一下 [儲存]。

輸出參數

輸出參數是會在退出元件後仍保持啟用的會話參數。這些參數包含元件收集的重要資訊。這個預先建構的元件會為下列輸出參數提供值：

參數名稱 說明 輸出格式
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 內建事件。		 字串

基本設定

如要設定這個預先建構的元件，請按照下列步驟操作：

  1. 匯入預先建構的元件。
  2. 使用描述外部服務的設定，設定提供的彈性 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，請展開操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 專案。
  3. 選取所需的代理程式。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhook」。
  6. 選取 prebuilt_components_account_services:validate_account webhook。
  7. 將 Conversational Agents (Dialogflow CX) Webhook 網址欄位中的網址，替換為要整合的服務端點。在下拉式選單中選取適當的「方法」。
  8. 查看並更新要求主體，為 webhook 建立適當的要求格式。
  9. 查看並更新回應設定，從 webhook 回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看並更新驗證設定。
  11. 按一下 [儲存]。

使用者卡片詳細資料

元件會使用 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，請展開查看操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 專案。
  3. 選取所需的代理程式。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhook」。
  6. 選取 prebuilt_components_make_a_payment:user_card_details webhook。
  7. 將 Conversational Agents (Dialogflow CX) Webhook 網址欄位中的網址，替換為要整合的服務端點。在下拉式選單中選取適當的「方法」。
  8. 查看並更新要求主體，為 webhook 建立適當的要求格式。
  9. 查看並更新回應設定，從 webhook 回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看並更新驗證設定。
  11. 按一下 [儲存]。

驗證受款人姓名

元件會使用 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，請展開查看操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 專案。
  3. 選取所需的代理程式。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhook」。
  6. 選取 prebuilt_components_make_a_payment:verify_beneficiary_name webhook。
  7. 將 Conversational Agents (Dialogflow CX) Webhook 網址欄位中的網址，替換為要整合的服務端點。在下拉式選單中選取適當的「方法」。
  8. 查看並更新要求主體，為 webhook 建立適當的要求格式。
  9. 查看並更新回應設定，從 webhook 回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看並更新驗證設定。
  11. 按一下 [儲存]。

取得應付金額

元件會使用 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 指定信用卡帳單的應付總金額。 數字

如要為這個元件設定「Get due amount」webhook，請展開操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 專案。
  3. 選取所需的代理程式。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhook」。
  6. 選取 prebuilt_components_make_a_payment:get_due_amount webhook。
  7. 將 Conversational Agents (Dialogflow CX) Webhook URL 欄位中的網址，替換為要整合的服務端點。在下拉式選單中選取適當的「方法」。
  8. 查看並更新要求主體，為 webhook 建立適當的要求格式。
  9. 查看並更新回應設定，從 webhook 回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看並更新驗證設定。
  11. 按一下 [儲存]。

驗證信用卡號碼

元件會使用 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，請展開查看操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 專案。
  3. 選取所需的代理程式。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhook」。
  6. 選取 prebuilt_components_make_a_payment:verify_credit_card_number webhook。
  7. 將 Conversational Agents (Dialogflow CX) Webhook URL 欄位中的網址，替換為要整合的服務端點。在下拉式選單中選取適當的「方法」。
  8. 查看並更新要求主體，為 webhook 建立適當的要求格式。
  9. 查看並更新回應設定，從 webhook 回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看並更新驗證設定。
  11. 按一下 [儲存]。

驗證信用卡詳細資料

元件會使用 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 使用者提供的特定信用卡到期日。 
{
  "year": integer,
  "month": integer
}
$flow.credit_card_cvv_code 使用者提供指定信用卡的 CVV 碼。 字串

API 回應參數

下列參數會從 API 回應中擷取，供元件使用。

參數名稱 說明 輸出格式
creditcard_verification_status 指出系統是否已驗證所提供的信用卡詳細資料。 布林值

如要為這個元件設定「驗證信用卡詳細資料」webhook，請展開查看操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 專案。
  3. 選取所需的代理程式。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhook」。
  6. 選取 prebuilt_components_make_a_payment:verify_credit_card_details webhook。
  7. 將 Conversational Agents (Dialogflow CX) Webhook URL 欄位中的網址，替換為要整合的服務端點。在下拉式選單中選取適當的「方法」。
  8. 查看並更新要求主體，為 webhook 建立適當的要求格式。
  9. 查看並更新回應設定，從 webhook 回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看並更新驗證設定。
  11. 按一下 [儲存]。

驗證簽帳金融卡資料

元件會使用 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 使用者提供的簽帳金融卡到期日。 
{
  "year": integer,
  "month": integer
}
$flow.debit_card_cvv_code 使用者提供指定簽帳金融卡的 CVV 碼。 字串

API 回應參數

下列參數會從 API 回應中擷取，供元件使用。

參數名稱 說明 輸出格式
debitcard_verification_status 指出是否已驗證所提供的簽帳金融卡詳細資料。 布林值

如要為這個元件設定「驗證簽帳金融卡詳細資料」webhook，請展開操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 專案。
  3. 選取所需的代理程式。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhook」。
  6. 選取 prebuilt_components_make_a_payment:verify_debit_card_details webhook。
  7. 將 Conversational Agents (Dialogflow CX) Webhook 網址欄位中的網址，替換為要整合的服務端點。在下拉式選單中選取適當的「方法」。
  8. 查看並更新要求主體，為 webhook 建立適當的要求格式。
  9. 查看並更新回應設定，從 webhook 回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看並更新驗證設定。
  11. 按一下 [儲存]。

處理信用卡付款

元件會使用 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 使用者提供的指定信用卡到期日。 
{
  "year": integer,
  "month": integer
}
$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，請展開操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 專案。
  3. 選取所需的代理程式。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhook」。
  6. 選取 prebuilt_components_make_a_payment:process_payment_credit_card webhook。
  7. 將 Conversational Agents (Dialogflow CX) Webhook 網址欄位中的網址，替換為要整合的服務端點。在下拉式選單中選取適當的「方法」。
  8. 查看並更新要求主體，為 webhook 建立適當的要求格式。
  9. 查看並更新回應設定，從 webhook 回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看並更新驗證設定。
  11. 按一下 [儲存]。

處理簽帳金融卡付款

元件會使用 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 使用者提供的簽帳金融卡到期日。 
{
  "year": integer,
  "month": integer
}
$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，請展開操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 專案。
  3. 選取所需的代理程式。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhook」。
  6. 選取 prebuilt_components_make_a_payment:process_payment_debit_card webhook。
  7. 將 Conversational Agents (Dialogflow CX) Webhook 網址欄位中的網址，替換為要整合的服務端點。在下拉式選單中選取適當的「方法」。
  8. 查看並更新要求主體，為 webhook 建立適當的要求格式。
  9. 查看並更新回應設定，從 webhook 回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看並更新驗證設定。
  11. 按一下 [儲存]。

處理帳戶付款

元件會使用 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 可設定的輸入參數定義。 字串

如要為這個元件設定 Process 帳戶付款 Webhook，請展開操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 專案。
  3. 選取所需的代理程式。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhook」。
  6. 選取 prebuilt_components_make_a_payment:process_payment_account webhook。
  7. 將 Conversational Agents (Dialogflow CX) Webhook 網址欄位中的網址，替換為要整合的服務端點。在下拉式選單中選取適當的「方法」。
  8. 查看並更新要求主體，為 webhook 建立適當的要求格式。
  9. 查看並更新回應設定，從 webhook 回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看並更新驗證設定。
  11. 按一下 [儲存]。

處理行動支付

元件會使用 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，請展開操作說明。

  1. 開啟 Dialogflow CX 控制台。
  2. 選擇 Google Cloud 專案。
  3. 選取所需的代理程式。
  4. 選取「管理」分頁標籤。
  5. 按一下「Webhook」。
  6. 選取 prebuilt_components_make_a_payment:process_payment_mobile webhook。
  7. 將 Conversational Agents (Dialogflow CX) Webhook 網址欄位中的網址，替換為要整合的服務端點。在下拉式選單中選取適當的「方法」。
  8. 查看並更新要求主體，為 webhook 建立適當的要求格式。
  9. 查看並更新回應設定，從 webhook 回應中擷取特定欄位。請勿修改參數名稱，因為元件需要這些名稱才能存取傳回的欄位值。
  10. 視需要查看並更新驗證設定。
  11. 按一下 [儲存]。

完成

代理程式和相關的 webhook 應已設定完成，可以開始測試。

上一頁
遺失和遭竊的卡片
下一頁
命名集合