“付款”预构建组件

“付款”预构建组件可对用户进行身份验证并允许用户进行付款。此组件使用自定义版本的 Authentication 预构建组件对帐号持有人和持卡人进行身份验证。该组件还使用名称收集、信用卡失效日期收集和信用卡 CVV 收集这些预构建组件来收集付款所需的信息。

付款方式

此组件支持信用卡账单和收款帐号付款。 对于信用卡账单，用户可以选择支付最低金额、总金额或自定义金额。用户可以通过其银行账户、借记卡/信用卡或移动付款进行付款。

付款方式 可用的付款方式 可用的付款金额
信用卡账单 银行账户、借记卡、移动支付 最低金额、总金额、自定义金额
收款人账户 银行账户、信用卡、借记卡、移动支付 自定义金额

限制

除了常见的预构建组件限制之外，此预构建组件还具有以下限制：

  • 该组件不加密任何数据。

示例对话框

以下示例对话框展示了此预构建组件处理的常见场景。这些示例对话框演示了通过电话调用组件时的行为，这会在对话开始时触发“默认欢迎意图”和第一个代理响应。

收款人账户付款

代理会识别用户之前未经过身份验证，并收集信息以验证用户是否为注册用户。用户表明他们想要向收款人帐号付款，代理将收集收款人名称等所需的信息并确认帐号。最后，用户选择使用借记卡付款，因此代理会收集借记卡号、失效日期和 CVV，并确认付款。

用户输入 代理响应
代理使用 Authentication 预构建组件对用户进行身份验证
谢谢，您已成功进行身份验证。
您是想要支付登记的信用卡账单，还是要将款项支付到现有的收款账号？
受益人
客服人员使用姓名收集预构建组件收集受益人姓名
谢谢，我们已收集收款人名称。

好的，根据我们的记录，我们有尾号为 7821 的帐号。请说“是”以确认账号。
是
请确认您要支付的金额。例如，如果您想支付 100.30 美元，就说 100 点 30。
50 美元
您希望通过银行账户、借记卡、信用卡还是移动支付方式付款？
借记卡
能否请您提供所指借记卡卡号的后 4 位数字？
1234
我们收到的借记卡号码的最后四位数是 1234，对吗？
是的，没错
代理使用 信用卡失效日期收集预构建组件收集借记卡失效日期
太好了，这张借记卡的失效日期信息我们搞定了。
客服人员使用信用卡 CVV 收集预构建组件收集借记卡 CVV
太好了，我们已完成 CVV 的收集。
好的，我们将使用尾号为 1234 的借记卡向 Jane 支付 50 美元。确定要执行此操作吗？
是
如要继续，我们将向您发送验证码。你想通过手机还是电子邮件接收验证码？
请发送电子邮件
我们已向您的注册电子邮件地址 john.doe@google.com 发送验证码。这可能需要几秒钟的时间。您可以确认一下该代码吗？
123456
好的，我们正在付款，请稍等几秒钟。

您的收款账号已成功支付款项。

信用卡账单付款

代理会识别用户之前未经过身份验证，并收集信息以验证用户是否为注册用户。用户表示他们想要使用自己的银行账户支付信用卡账单费用。代理确认付款金额和付款方式详情，然后完成付款。

用户输入 代理响应
代理使用 Authentication 预构建组件对用户进行身份验证
谢谢，您已成功进行身份验证。
您是想要支付登记的信用卡账单，还是要将款项支付到现有的收款账号？
信用卡账单
能否请您提供所提及的信用卡号的最后 4 位数字？
4321
我们收到的信用卡号的最后四位数是 4321，对吗？
是
您的应付总金额为 300 美元，最低付款金额为 20 美元。您想要支付总金额、最低金额还是其他金额？
总金额
您希望通过银行账户、借记卡还是移动支付方式付款？
储蓄账户
我们发现有 2 个账号与您的电话号码关联。能否请您提供所提及帐号的后 4 位数字？
1001
我们获得的账号的后四位数字是 1001，对吗？
是
好的，我们将为尾号为 4321 的信用卡账单（账号尾号为 1001）支付 300 美元。确定要执行此操作吗？
是
如要继续，我们将向您发送验证码。你想通过手机还是电子邮件接收验证码？
发送到我的电子邮件地址
我们已向您的注册电子邮件地址 john.doe@google.com 发送验证码。这可能需要几秒钟的时间。您可以确认一下该代码吗？
123456
好的，我们正在付款，请稍等几秒钟。

您的信用卡付款已成功。

资金不足或限额

代理会识别用户之前未经过身份验证，并收集信息以验证用户是否为注册用户。用户尝试使用其银行账户和借记卡支付信用卡账单，但由于资金不足或限额不足，两笔付款都被拒绝。最后，用户选择进行移动付款，代理会向其发送一个链接，以便用户通过移动设备完成付款。

用户输入 代理响应
代理使用 Authentication 预构建组件对用户进行身份验证
谢谢，您已成功进行身份验证。
您是想要支付登记的信用卡账单，还是要将款项支付到现有的收款账号？
信用卡
能否请您提供所提及的信用卡号的最后 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
好的，请稍等几秒钟，我们正在付款。

由于借记卡的额度超出了上限，因此您的付款失败了。要通过其他付款方式重新尝试付款吗？
是
您希望通过银行账户、借记卡还是移动支付方式付款？
Mobile
好的，我们正在将付款链接发送到您注册的手机号码。此操作可能需要几秒钟的时间。如果您已经收到，请说“是”进行确认。
是
太好了，现在您可以打开该链接并继续付款了。

命名惯例

此预构建组件使用以下命名惯例：

特征 形式 示例
流 [组件名称] 付款
组件专用 intent 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。 boolean
$session.params.card_auth_enabled 用于指明用户是否应该以持卡人身份接受身份验证（如身份验证类型中所述）。此值在 check auth level 页面中页面条目执行方式的参数预设中配置。默认情况下，此值为 false。 boolean
$session.params.phone_number （可选）用于验证身份的客户已注册手机号码。 字符串
$flow.payment_success_code 指定 process_payment 网络钩子返回的 payment_status_code 字段的值，用于表明付款成功。默认情况下，此值为 "200"。 字符串
$flow.infull_fund_code 指定 process_payment 网络钩子返回的 payment_status_code 字段的值，用于表明因资金不足而无法完成付款。默认情况下，此值为 "400"。 字符串
$flow.limit_exceed_code 指定 process_payment 网络钩子返回的 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. 点击初始页中的 true 路由。
  8. 在“路由”窗口中，根据需要修改参数预设值。
  9. 点击保存。

输出参数

输出参数是在退出组件后将保持活跃状态的会话参数。这些参数包含该组件收集的重要信息。此预构建组件提供了以下输出参数的值：

参数名称 说明 输出格式
auth_level 指示调用方的身份验证级别。 整数
phone_number 用于识别用户的用户的本地手机号码（不含国家/地区代码）。 字符串
transfer_reason 此参数指示数据流退出的原因（如果失败的话）。返回值为以下值之一：

agent：在对话期间的某个时间点，最终用户请求了人工客服。

denial_of_information：最终用户拒绝分享该组件请求的信息。

max_no_input：对话已达到无输入事件的重试次数上限。请参阅无输入内置事件。

max_no_match：对话已达到无匹配事件的重试次数上限。请参阅无匹配的内置事件。

webhook_error：发生了网络钩子错误。请参阅 webhook.error 内置事件。

webhook_not_found：无法访问网络钩子网址。请参阅 webhook.error.not-found 内置事件。		 字符串

基本设置

如需设置此预构建组件，请执行以下操作：

  1. 导入预构建组件。
  2. 使用描述 Dialogflow 外部服务的配置来配置所提供的灵活 webhook，请参阅下面的 webhook 设置。

网络钩子设置

为了使用此组件，您需要配置所包含的灵活网络钩子，以从外部服务中检索所需信息。

Authentication

如果您之前未配置过身份验证所需的外部服务，则需要对其进行配置，以便为此组件启用用户身份验证功能。如需查看详细说明，请参阅 Authentication 网络钩子设置。

验证账号

该组件使用 prebuilt_components_account_services:validate_account 网络钩子，根据用户的注册手机号码和所提供帐号的最后四位数来验证帐号是否存在。如果存在帐号，网络钩子还会返回帐号余额。

API 请求参数

以下参数由组件提供，作为 API 请求的输入。

参数名称 说明 输入格式
$session.params.phone_number 用于识别用户的用户的本地手机号码（不含国家/地区代码）。 字符串
$session.params.last_four_digit_of_account_number 用户选择并确认付款的账号的后四位数。 字符串

API 响应参数

以下参数是从 API 响应中提取的，供组件使用。

参数名称 说明 输出格式
account_found 指明用户的注册帐号是否存在提供后四位数字的帐号。 boolean
余额 相关账号的当前余额（如有）。 数字

如需为此组件配置“验证帐号”网络钩子，请展开查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhook。
  6. 选择 build_components_account_services:validate_account 网络钩子。
  7. 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
  8. 查看并更新请求正文，以构成网络钩子的正确请求格式。
  9. 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件必须使用这些参数名称才能访问返回的字段值。
  10. 查看并视需要更新 Authentication 设置。
  11. 点击保存。

用户卡详细信息

该组件使用 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。 字符串

如需为此组件配置“用户卡片详细信息”网络钩子，请展开查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhook。
  6. 选择预建组件_make_a_payment:user_card_details webhook。
  7. 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
  8. 查看并更新请求正文，以构成网络钩子的正确请求格式。
  9. 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件必须使用这些参数名称才能访问返回的字段值。
  10. 查看并视需要更新 Authentication 设置。
  11. 点击保存。

验证收款人姓名

该组件使用 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。 字符串

如需为此组件配置“验证收款人名称”网络钩子，请展开查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhook。
  6. 选择预建组件_make_a_payment:verify_beneficiary_name 网络钩子。
  7. 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
  8. 查看并更新请求正文，以构成网络钩子的正确请求格式。
  9. 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件必须使用这些参数名称才能访问返回的字段值。
  10. 查看并视需要更新 Authentication 设置。
  11. 点击保存。

获取应付金额

该组件使用 prebuilt_components_make_a_payment:get_due_amount 网络钩子来获取用户信用卡账单的最低应付金额和总金额信息。

API 请求参数

以下参数由组件提供，作为 API 请求的输入。

参数名称 说明 输入格式
$session.params.phone_number 用于识别用户的用户的本地手机号码（不含国家/地区代码）。 字符串
$flow.user_credit_card_number 用户信用卡的后四位数字。 字符串

API 响应参数

以下参数是从 API 响应中提取的，供组件使用。

参数名称 说明 输出格式
minimum_amount 指定信用卡账单的最低应付金额。 数字
total_amount 指定信用卡账单的应付总金额。 数字

如需为此组件配置“获取应付金额”网络钩子，请展开查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhook。
  6. 选择预建组件_make_a_payment:get_due_amount 网络钩子。
  7. 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
  8. 查看并更新请求正文，以构成网络钩子的正确请求格式。
  9. 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件必须使用这些参数名称才能访问返回的字段值。
  10. 查看并视需要更新 Authentication 设置。
  11. 点击保存。

验证信用卡号

prebuilt_components_make_a_payment:verify_credit_card_number 网络钩子用于验证所提供的信用卡号是否已注册到用户的帐号中。

API 请求参数

以下参数由组件提供，作为 API 请求的输入。

参数名称 说明 输入格式
$session.params.phone_number 用于识别用户的用户的本地手机号码（不含国家/地区代码）。 字符串
$flow.user_credit_card_number 用户信用卡的后四位数字。 字符串

API 响应参数

以下参数是从 API 响应中提取的，供组件使用。

参数名称 说明 输出格式
card_found 指明是否找到了提供的信用卡。 boolean

如需为此组件配置“验证信用卡号”网络钩子，请展开查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhook。
  6. 选择预建组件_make_a_payment:verify_credit_card_number 网络钩子。
  7. 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
  8. 查看并更新请求正文，以构成网络钩子的正确请求格式。
  9. 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件必须使用这些参数名称才能访问返回的字段值。
  10. 查看并视需要更新 Authentication 设置。
  11. 点击保存。

验证信用卡详细信息

该组件使用 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 用户提供的特定信用卡的信用卡失效日期。 

{
  "year": integer,
  "month": integer
}
$flow.credit_card_cvv_code 用户提供的指定信用卡的 CVV 代码。 字符串

API 响应参数

以下参数是从 API 响应中提取的，供组件使用。

参数名称 说明 输出格式
creditcard_verification_status 指明提供的信用卡详细信息是否经过验证。 boolean

如需为此组件配置“验证信用卡详细信息”网络钩子，请展开查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhook。
  6. 选择预建组件_make_a_payment:verify_credit_card_details 网络钩子。
  7. 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
  8. 查看并更新请求正文，以构成网络钩子的正确请求格式。
  9. 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件必须使用这些参数名称才能访问返回的字段值。
  10. 查看并视需要更新 Authentication 设置。
  11. 点击保存。

验证借记卡详细信息

该组件使用 prebuilt_components_make_a_payment:verify_debit_card_details 网络钩子来验证所提供的详细信息（包括失效日期和 CVV）是否对用户提供的借记卡有效。

API 请求参数

以下参数由组件提供，作为 API 请求的输入。

参数名称 说明 输入格式
$session.params.phone_number 用于识别用户的用户的本地手机号码（不含国家/地区代码）。 字符串
$flow.offline_card_number 用户借记卡的后四位数字。 字符串
$flow.debit_card_exp_date 用户为指定借记卡提供的借记卡失效日期。 

{
  "year": integer,
  "month": integer
}
$flow.debit_card_cvv_code 用户为指定借记卡提供的 CVV 代码。 字符串

API 响应参数

以下参数是从 API 响应中提取的，供组件使用。

参数名称 说明 输出格式
debitcard_verification_status 指明提供的借记卡详细信息是否经过验证。 boolean

如需为此组件配置“验证借记卡详细信息”网络钩子，请展开查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhook。
  6. 选择预建组件_make_a_payment:verify_offline_card_details webhook。
  7. 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
  8. 查看并更新请求正文，以构成网络钩子的正确请求格式。
  9. 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件必须使用这些参数名称才能访问返回的字段值。
  10. 查看并视需要更新 Authentication 设置。
  11. 点击保存。

处理信用卡付款

组件使用 prebuilt_components_make_a_payment:process_payment_credit_card 网络钩子，通过提供的信用卡详细信息处理付款。

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 可配置的输入参数定义。 字符串

如需为此组件配置“处理信用卡付款”网络钩子，请展开查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhook。
  6. 选择预建组件_make_a_payment:process_payment_credit_card 网络钩子。
  7. 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
  8. 查看并更新请求正文，以构成网络钩子的正确请求格式。
  9. 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件必须使用这些参数名称才能访问返回的字段值。
  10. 查看并视需要更新 Authentication 设置。
  11. 点击保存。

处理借记卡付款

组件使用 prebuilt_components_make_a_payment:process_payment_debit_card 网络钩子，通过所提供的借记卡详细信息处理付款。

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.offline_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 可配置的输入参数定义。 字符串

如需为此组件配置“处理借记卡付款”网络钩子，请展开查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhook。
  6. 选择预建组件_make_a_payment:process_payment_offline_card 网络钩子。
  7. 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
  8. 查看并更新请求正文，以构成网络钩子的正确请求格式。
  9. 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件必须使用这些参数名称才能访问返回的字段值。
  10. 查看并视需要更新 Authentication 设置。
  11. 点击保存。

处理账号付款

组件使用 prebuilt_components_make_a_payment:process_payment_account 网络钩子，根据提供的帐号详细信息处理付款。

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 可配置的输入参数定义。 字符串

如需为此组件配置处理账号付款网络钩子，请展开查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhook。
  6. 选择预建组件_make_a_payment:process_payment_account 网络钩子。
  7. 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
  8. 查看并更新请求正文，以构成网络钩子的正确请求格式。
  9. 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件必须使用这些参数名称才能访问返回的字段值。
  10. 查看并视需要更新 Authentication 设置。
  11. 点击保存。

处理移动付款

该组件使用 prebuilt_components_make_a_payment:process_payment_mobile 网络钩子为用户所选的付款信息生成和发送移动付款链接。

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 指明移动付款链接是否已成功生成并发送给用户。 boolean

如需为此组件配置“Process mobile payment webhook”，请展开查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhook。
  6. 选择预建组件_make_a_payment:process_payment_mobile 网络钩子。
  7. 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
  8. 查看并更新请求正文，以构成网络钩子的正确请求格式。
  9. 查看并更新响应配置，以从 webhook 的响应中提取特定字段。请勿修改参数名称，因为组件必须使用这些参数名称才能访问返回的字段值。
  10. 查看并视需要更新 Authentication 设置。
  11. 点击保存。

完成

现在，您的代理及其 webhook 应该已设置完毕，可以开始测试了。

上一页
银行卡丢失或被盗
下一页
名称合集