O componente pré-criado fazer um pagamento autentica o usuário e permite que ele faça um pagamento. Ele usa uma versão personalizada do componente pré-criado Authentication para autenticar titulares de contas e titulares de cartões. O componente também usa os componentes pré-criados Coleta de nomes, Coleta da data de validade do cartão de crédito e Coleta do CVV do cartão de crédito para coletar as informações necessárias para fazer pagamentos.
Tipos de pagamento
Este componente oferece suporte a pagamentos de faturas de cartão de crédito e contas de beneficiários. Em faturas de cartão de crédito, os usuários podem optar por pagar o valor mínimo, total ou um valor personalizado. O usuário pode efetuar pagamentos usando a conta bancária, cartão de débito, crédito ou pagamento móvel.
| Tipo de pagamento | Formas de pagamento disponíveis | Valores de pagamento disponíveis |
|---|---|---|
| Fatura do cartão de crédito | Conta bancária, cartão de débito, pagamento móvel | Valor mínimo, total e personalizado |
| Conta do beneficiário | Conta bancária, cartão de crédito, cartão de débito, pagamento com celular | Valor personalizado |
Limitações
Além das limitações comuns de componentes pré-criados, esse componente pré-criado tem as seguintes limitações:
- Este componente não criptografa nenhum dado.
Exemplos de diálogos
As caixas de diálogo de exemplo abaixo demonstram cenários comuns processados por esse componente pré-criado. As caixas de diálogo de exemplo demonstram o comportamento quando o componente é chamado por telefonia, o que aciona a intent de boas-vindas padrão e a primeira resposta do agente no início da conversa.
Pagamento na conta do beneficiário
O agente identifica que o usuário não foi autenticado anteriormente e coleta informações para verificar se o usuário é registrado. O usuário indica que quer fazer um pagamento a uma conta do beneficiário e o agente coleta as informações necessárias, incluindo o nome do beneficiário, e confirma o número da conta. Por fim, o usuário seleciona o pagamento com um cartão de débito, para que o agente colete o número, a data de validade e o CVV do cartão, e confirma o pagamento.
| Entrada do usuário | Resposta do agente |
|---|---|
| O agente autentica o usuário usando o componente pré-criado Authentication | |
| Agradecemos sua autenticação. | |
| Quer pagar a fatura do seu cartão de crédito registrado ou fazer um pagamento para uma conta de beneficiário existente? | |
| Beneficiário | |
| O agente coleta o nome do beneficiário usando o componente pré-criado Coleção de nomes | |
| Obrigado. Coletamos o nome do beneficiário. Ok, com base nos nossos registros, temos o número da conta com final 7821. Diga "sim" para confirmar o número da conta. |
|
| Sim | |
| Confirme o valor que você quer pagar. Por exemplo, se você quiser pagar R $100,30, diga 100,30. | |
| 50 dólares | |
| Quer pagar usando sua conta bancária, cartão de débito, cartão de crédito ou celular? | |
| Débito | |
| Informe os últimos quatro dígitos do número do cartão de débito ao qual você está se referindo. | |
| 1234 | |
| Os últimos quatro dígitos do número do cartão de débito que recebemos são 1234, correto? | |
| Sim, isso mesmo | |
| O agente coleta a data de validade do cartão de débito usando o componente pré-criado coleta da data de validade do cartão de crédito | |
| Ótimo! Concluímos a coleta da data de validade do cartão de débito. | |
| O agente coleta o CVV do cartão de débito usando o componente pré-criado coleta do CVV do cartão de crédito | |
| Ótimo, terminamos de coletar o CVV. | |
| Tudo bem. Vamos fazer um pagamento de $50 para Jane usando o número do cartão de débito com final 1234. Você confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Prefere receber o código por telefone ou e-mail? | |
| Envie um e-mail | |
| Enviamos um código para o e-mail registrado: john.doe@google.com. Isso pode levar alguns segundos. Você pode confirmar o código? | |
| 123456 | |
| Certo. Aguarde alguns segundos enquanto fazemos o pagamento. O pagamento da sua conta de beneficiário foi bem-sucedido. |
Pagamento da fatura do cartão de crédito
O agente identifica que o usuário não foi autenticado anteriormente e coleta informações para verificar se o usuário é registrado. Ele indica que gostaria de fazer um pagamento na fatura do cartão de crédito usando a conta bancária. O agente confirma o valor e os detalhes da forma de pagamento e conclui o pagamento.
| Entrada do usuário | Resposta do agente |
|---|---|
| O agente autentica o usuário usando o componente pré-criado Authentication | |
| Agradecemos sua autenticação. | |
| Quer pagar a fatura do seu cartão de crédito registrado ou fazer um pagamento para uma conta de beneficiário existente? | |
| Fatura do cartão de crédito | |
| Informe os últimos quatro dígitos do número do cartão de crédito a que você se refere. | |
| 4321 | |
| Os últimos quatro dígitos do número do cartão de crédito que recebemos são 4321, correto? | |
| Sim | |
| O valor total devido é de US $300, e o mínimo é de US $20. Quer pagar o valor total, mínimo ou qualquer outro valor? | |
| Valor total | |
| Quer pagar usando sua conta bancária, cartão de débito ou usando seu dispositivo móvel? | |
| Conta poupança | |
| Descobrimos que há duas contas associadas ao seu número. Informe os últimos quatro dígitos da conta a que você está se referindo. | |
| 1001 | |
| Os últimos quatro dígitos do número da conta que recebemos são 1001, correto? | |
| Sim | |
| Certo, vamos fazer o pagamento de $300 da fatura do seu cartão de crédito com final 4321 e número de conta que termina em 1001. Você confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Prefere receber o código por telefone ou e-mail? | |
| Enviar para meu e-mail | |
| Enviamos um código para o e-mail registrado: john.doe@google.com. Isso pode levar alguns segundos. Você pode confirmar o código? | |
| 123456 | |
| Certo. Aguarde alguns segundos enquanto fazemos o pagamento. O pagamento com cartão de crédito foi concluído. |
Fundos ou limites insuficientes
O agente identifica que o usuário não foi autenticado anteriormente e coleta informações para verificar se o usuário é registrado. O usuário tenta fazer pagamentos na fatura do cartão de crédito usando a conta bancária e o cartão de débito, mas os dois são recusados devido a fundos ou limites insuficientes. Por fim, o usuário opta por fazer um pagamento em um dispositivo móvel, e o agente envia um link para concluir o pagamento pelo dispositivo móvel.
| Entrada do usuário | Resposta do agente |
|---|---|
| O agente autentica o usuário usando o componente pré-criado Authentication | |
| Agradecemos sua autenticação. | |
| Quer pagar a fatura do seu cartão de crédito registrado ou fazer um pagamento para uma conta de beneficiário existente? | |
| Cartão de crédito | |
| Informe os últimos quatro dígitos do número do cartão de crédito a que você se refere. | |
| 4321 | |
| Os últimos quatro dígitos do número do cartão de crédito que recebemos são 4321, correto? | |
| Sim | |
| O valor total devido é de US $300, e o mínimo é de US $20. Quer pagar o valor total, mínimo ou qualquer outro valor? | |
| Valor total | |
| Quer pagar usando sua conta bancária, cartão de débito ou usando seu dispositivo móvel? | |
| Economia | |
| Descobrimos que há duas contas associadas ao seu número. Informe os últimos quatro dígitos da conta a que você está se referindo. | |
| 1002 | |
| Os últimos quatro dígitos do número da conta que obtivemos são 1002, correto? | |
| Sim | |
| Certo, vamos fazer o pagamento de $300 da fatura do seu cartão de crédito com final 4321 e número de conta que termina em 1002. Você confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Prefere receber o código por telefone ou e-mail? | |
| Enviamos um código para o e-mail registrado: john.doe@google.com. Isso pode levar alguns segundos. Você pode confirmar o código? | |
| 123456 | |
| OK. Aguarde alguns segundos enquanto fazemos o pagamento. Não foi possível concluir o pagamento porque você não tem saldo suficiente na conta. Quer tentar pagar novamente usando outra forma de pagamento? |
|
| Sim | |
| Quer pagar usando sua conta bancária, cartão de débito ou usando seu dispositivo móvel? | |
| Cartão de débito | |
| Informe os últimos quatro dígitos do número do cartão de débito ao qual você está se referindo. | |
| 2345 | |
| Os últimos quatro dígitos do número do cartão de débito que recebemos são 2345, correto? | |
| Sim | |
| O agente coleta a data de validade do cartão de débito usando o componente pré-criado coleta da data de validade do cartão de crédito | |
| Ótimo! Concluímos a coleta da data de validade do cartão de débito. | |
| O agente coleta o CVV do cartão de débito usando o componente pré-criado coleta do CVV do cartão de crédito | |
| Ótimo, terminamos de coletar o CVV. | |
| Tudo bem. Vamos fazer o pagamento de $300 da fatura do seu cartão de crédito com final 4321, com o número do cartão de débito que termina em 2345. Você confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Prefere receber o código por telefone ou e-mail? | |
| Enviamos um código para o e-mail registrado: john.doe@google.com. Isso pode levar alguns segundos. Você pode confirmar o código? | |
| 123456 | |
| Certo. Aguarde alguns segundos enquanto fazemos o pagamento. O pagamento falhou porque o limite do cartão de débito foi ultrapassado. Quer tentar pagar novamente usando outra forma de pagamento? |
|
| Sim | |
| Quer pagar usando sua conta bancária, cartão de débito ou usando seu dispositivo móvel? | |
| Dispositivos móveis | |
| Certo, vamos enviar o link de pagamento para seu número de celular registrado. Isso pode levar alguns segundos. Confirme dizendo que sim. | |
| Sim | |
| Ótimo, agora você pode abrir o link e continuar o pagamento. |
Convenções de nomeação
Esse componente pré-criado usa as seguintes convenções de nomenclatura:
| Recurso | Formato | Exemplo |
|---|---|---|
| Fluxo | [Nome do componente] | Efetuar um pagamento |
| Intent específica do componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_make_a_payment_payment_type |
| Tipo da entidade | 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 |
Parâmetros de entrada
Os parâmetros de entrada são usados para configurar determinados comportamentos do componente. Os parâmetros são usados por uma ou mais condições no fluxo para determinar como o componente vai se comportar. Os parâmetros com escopo de fluxo precisam ser definidos na página inicial do componente, conforme descrito abaixo. Os parâmetros no escopo da sessão podem ser definidos por um fluxo de chamada ou na página inicial desse componente.
Esse componente pré-criado aceita os seguintes parâmetros de entrada:
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.auth_level | (opcional) Indica o nível de autenticação do autor da chamada. | integer |
| $session.params.auth_level_req | Indica o nível de autenticação necessário para que um usuário possa acessar o histórico de transações. Esse valor é configurado nas predefinições de parâmetros do fulfillment de entrada de página na página check auth level. Por padrão, esse valor é 1. |
integer |
| $session.params.account_auth_enabled | Indica se o usuário deve ser autenticado como proprietário da conta, conforme descrito em Tipos de autenticação. Esse valor é configurado nas predefinições de parâmetros do fulfillment de entrada de página na página check auth level. Por padrão, esse valor é true. |
boolean |
| $session.params.card_auth_enabled | Indica se o usuário deve ser autenticado como titular do cartão, conforme descrito em Tipos de autenticação. Esse valor é configurado nas predefinições de parâmetros do fulfillment de entrada de página na página check auth level. Por padrão, esse valor é false. |
boolean |
| $session.params.phone_number | (Opcional) Número de telefone registrado do cliente usado para autenticação. | string |
| $flow.payment_success_code | Especifica o valor do campo payment_status_code retornado pelos webhooks process_payment indicando que o pagamento foi realizado. Por padrão, esse
valor é "200". |
string |
| $flow.insufficient_fund_code | Especifica o valor do campo payment_status_code retornado pelos webhooks process_payment indicando que o pagamento não pôde ser concluído devido a fundos insuficientes. Por padrão, esse
valor é "400". |
string |
| $flow.limit_exceed_code | Especifica o valor do campo payment_status_code retornado pelos webhooks process_payment indicando que o pagamento não pôde ser concluído porque o limite diário foi excedido. Por padrão, esse
valor é "401". |
string |
| $flow.max_retry_mop_counter | Especifica o número de vezes que um usuário pode alterar a forma de pagamento. O valor padrão é 2. |
integer |
| $flow.max_retry_credit_card_payment | Especifica o número de novas tentativas permitidas ao tentar fazer um pagamento usando um cartão de crédito como forma de pagamento. O valor padrão é 3. |
integer |
| $flow.max_retry_mobile_payment_counter | Especifica o número de novas tentativas permitidas ao tentar fazer um pagamento usando dispositivos móveis como forma de pagamento. O valor padrão é 2. |
integer |
| $flow.max_retry_creditcard_count | Especifica o número de novas tentativas permitidas ao coletar um número válido de cartão de crédito para fazer um pagamento. O valor padrão é 3. |
integer |
| $flow.max_retry_acc_number | Especifica o número de tentativas permitidas ao coletar detalhes válidos da conta para fazer um pagamento. O valor padrão é 3. |
integer |
| $flow.max_retry_debit_card_details | Especifica o número de tentativas permitidas ao coletar detalhes válidos do cartão de débito para fazer um pagamento. O valor padrão é 3. |
integer |
| $flow.max_retry_credit_card_details | Especifica o número de novas tentativas permitidas ao coletar detalhes válidos do cartão de crédito para fazer um pagamento. O valor padrão é 3. |
integer |
| $flow.otp_length | Especifica o tamanho esperado da senha única enviada ao usuário. O valor padrão é 6. |
integer |
| $flow.max_retry_otp_count | Especifica o número de tentativas permitidas ao coletar uma senha única (OTP) válida do usuário. O valor padrão é 3. |
integer |
| $flow.max_waiting_room_counter | Especifica o número de vezes que o usuário pode pedir que o agente aguarde até receber o link de pagamento em dispositivo móvel. O valor padrão é 2. |
integer |
Para configurar os parâmetros de entrada desse componente, abra para conferir as instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Build.
- Clique no componente importado na seção Fluxos.
- Clique na página inicial na seção Páginas.
- Clique na rota true na página inicial.
- Na janela "Rota", edite os valores de Predefinições de parâmetros conforme necessário.
- Clique em Save.
Parâmetros de saída
Os parâmetros de saída são parâmetros de sessão que permanecerão ativos após a saída do componente. Esses parâmetros contêm informações importantes coletadas pelo componente. Esse componente pré-criado fornece valores para os seguintes parâmetros de saída:
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| auth_level | Indica o nível de autenticação do autor da chamada. | integer |
| phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| transfer_reason | Esse parâmetro indica o motivo pelo qual o fluxo saiu, se não tiver sido bem-sucedido. O valor retornado é um dos seguintes:agent: o usuário final solicitou um agente humano em algum momento durante a conversa.denial_of_information: o usuário final se recusou a compartilhar as informações solicitadas pelo componente.max_no_input: a conversa atingiu o número máximo de tentativas para eventos sem entrada. Veja os eventos integrados sem entrada.max_no_match: a conversa atingiu o número máximo de tentativas para eventos sem correspondência. Consulte eventos integrados sem correspondência.webhook_error: ocorreu um erro de webhook. Consulte o evento integrado webhook.error. webhook_not_found: não foi possível acessar um URL do webhook. Consulte o evento integrado webhook.error.not-found. |
string |
Configuração básica
Para configurar esse componente pré-criado:
- Importe o componente pré-criado.
- Configure os webhooks flexíveis fornecidos com a configuração que descreve os serviços externos do Dialogflow. Consulte "Configuração do webhook" abaixo.
Configuração do webhook
Para usar esse componente, é preciso configurar os webhooks flexíveis incluídos para recuperar as informações necessárias dos serviços externos.
Authentication
Se você não tiver configurado serviços externos necessários para autenticação, configure-os para ativar a autenticação de usuários nesse componente. Consulte Configuração do webhook de autenticação para instruções detalhadas.
Validar conta
O webhook prebuilt_components_account_services:validate_account é usado
pelo componente para verificar se uma conta existe com base no número de telefone
registrado do usuário e nos últimos quatro dígitos do número da conta fornecido.
O webhook também retorna o saldo da conta, se ela existir.
Parâmetros de solicitação de API
Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| $session.params.last_four_digit_of_account_number | Os últimos quatro dígitos do número da conta que o usuário selecionou e confirmou para efetuar um pagamento. | string |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| account_found | Indica se existe uma conta com os últimos quatro dígitos da conta registrada do usuário. | boolean |
| saldo | O valor do saldo atual na conta, se houver. | number |
Para configurar o webhook de validação da conta para este componente, abra as instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_account_services:validate_account.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Detalhes do cartão de usuário
O webhook prebuilt_components_make_a_payment:user_card_details é usado
pelo componente para coletar detalhes dos cartões de débito e crédito de um usuário registrado.
Parâmetros de solicitação de API
Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| credit_card_count | Número de cartões de crédito associados ao número de telefone registrado. | integer |
| last_four_digit_of_credit_card_number | Quatro últimos dígitos do cartão de crédito do usuário. Se o cliente tiver vários cartões de crédito, esse valor será null. |
string |
| debit_card_count | Número de cartões de débito associados ao número de telefone registrado. | integer |
| last_four_digit_of_debit_card_number | Quatro últimos dígitos do cartão de débito do usuário. Se o cliente tiver vários cartões de débito, esse valor será null. |
string |
Para configurar o webhook de detalhes do card de usuário para este componente, abra as instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_make_a_payment:user_card_details.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Verificar o nome do beneficiário
O webhook prebuilt_components_make_a_payment:verify_beneficiary_name é usado
pelo componente para verificar se existe uma conta de beneficiário para o nome
fornecido pelo usuário.
Parâmetros de solicitação de API
Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| $session.params.name_collection_first_name | Nome do beneficiário. | string |
| $session.params.name_collection_last_name | Sobrenome do beneficiário. | string |
| $session.params.name_collection_middle_name | Nome do meio do beneficiário. | string |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| beneficiary_account_number | Quatro últimos dígitos do número da conta do beneficiário fornecido para o nome dele. Se uma conta de beneficiário para o nome fornecido não for encontrado, o valor será null. |
string |
Para configurar o webhook "Verificar nome do beneficiário" deste componente, expanda para instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_make_a_payment:verify_beneficiary_name.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Receber valor devido
O webhook prebuilt_components_make_a_payment:get_due_amount é usado
pelo componente para coletar informações sobre o valor mínimo e total devido da
fatura do cartão de crédito do usuário.
Parâmetros de solicitação de API
Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| $flow.user_credit_card_number | Quatro últimos dígitos do cartão de crédito do usuário. | string |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| minimum_amount | Valor mínimo devido para a fatura do cartão de crédito especificada. | number |
| total_amount | Valor total devido para a fatura do cartão de crédito especificada. | number |
Para configurar o webhook "Receber valor devido" para este componente, expanda para ver instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_make_a_payment:get_due_amount.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Verificar número do cartão de crédito
O webhook prebuilt_components_make_a_payment:verify_credit_card_number é usado
pelo componente para verificar se o número do cartão de crédito fornecido está registrado
na conta do usuário.
Parâmetros de solicitação de API
Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| $flow.user_credit_card_number | Quatro últimos dígitos do cartão de crédito do usuário. | string |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| card_found | Indica se o cartão de crédito fornecido foi encontrado. | boolean |
Para configurar o webhook "Verificar número do cartão de crédito" deste componente, expanda para ver instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_make_a_payment:verify_credit_card_number.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Verificar os detalhes do cartão de crédito
O webhook prebuilt_components_make_a_payment:verify_credit_card_details é usado
pelo componente para verificar se os detalhes fornecidos, incluindo data de validade
e código de segurança do cartão (CSC), são válidos para o cartão de crédito fornecido pelo usuário.
Parâmetros de solicitação de API
Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| $flow.credit_card_number | Quatro últimos dígitos do cartão de crédito do usuário. | string |
| $flow.credit_card_exp_date | Data de validade do cartão de crédito fornecido pelo usuário para o cartão de crédito específico. |
{ |
| $flow.credit_card_cvv_code | Código CVV fornecido pelo usuário para o cartão de crédito especificado. | string |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| creditcard_verification_status | Indica se os detalhes do cartão de crédito fornecidos foram validados. | boolean |
Para configurar o webhook "Verificar detalhes do cartão de crédito" deste componente, expanda para ver instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_make_a_payment:verify_credit_card_details.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Verificar os detalhes do cartão de débito
O webhook prebuilt_components_make_a_payment:verify_debit_card_details é usado
pelo componente para verificar se os detalhes fornecidos, incluindo data de validade
e CVV, são válidos para o cartão de débito informado pelo usuário.
Parâmetros de solicitação de API
Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| $flow.débito_card_number | Quatro últimos dígitos do cartão de débito do usuário. | string |
| $flow.debit_card_exp_date | Data de validade do cartão de débito fornecido pelo usuário para o cartão de débito especificado. |
{ |
| $flow.debit_card_cvv_code | Código CVV fornecido pelo usuário para o cartão de débito especificado. | string |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| debitcard_verification_status | Indica se os detalhes do cartão de débito fornecidos foram validados. | boolean |
Para configurar o webhook "Verificar detalhes do cartão de débito" deste componente, abra as instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_make_a_payment:verify_ intent_card_details.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Processar pagamento com cartão de crédito
O webhook prebuilt_components_make_a_payment:process_payment_credit_card é usado
pelo componente para processar um pagamento usando os detalhes do cartão de crédito fornecidos.
Parâmetros de solicitação de API
Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| $flow.payee_number | Quatro últimos dígitos do número da conta do beneficiário para o pagamento. | string |
| $flow.payment_type | Tipo de pagamento. Os valores válidos são definidos pela entidade personalizada prebuilt_components_make_a_payment_payment_type. Por padrão, este componente oferece suporte a "beneficiary_pay" e "credit_card_pay". |
string |
| $flow.credit_card_number | Quatro últimos dígitos do cartão de crédito do usuário. | string |
| $flow.credit_card_exp_date | Data de validade do cartão de crédito fornecido pelo usuário para o cartão de crédito especificado. |
{ |
| $flow.credit_card_cvv_code | Código CVV fornecido pelo usuário para o cartão de crédito especificado. | string |
| $flow.payment_amount | É o valor que o usuário optou por pagar. | number |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| payment_status_code | Indica se o pagamento foi bem-sucedido. Os valores válidos são definidos pelos parâmetros de entrada configuráveis $flow.payment_success_code, $flow.insufficient_fund_code e $flow.limit_exceed_code. |
string |
Para configurar o webhook "Processar pagamento com cartão de crédito" para este componente, abra as instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_make_a_payment:process_payment_credit_card.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Processar pagamento com cartão de débito
O webhook prebuilt_components_make_a_payment:process_payment_debit_card é usado
pelo componente para processar um pagamento usando os detalhes do cartão de débito fornecidos.
Parâmetros de solicitação de API
Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| $flow.payee_number | Quatro últimos dígitos do número da conta do beneficiário para o pagamento. | string |
| $flow.payment_type | Tipo de pagamento. Os valores válidos são definidos pela entidade personalizada prebuilt_components_make_a_payment_payment_type. Por padrão, este componente oferece suporte a "beneficiary_pay" e "credit_card_pay". |
string |
| $flow.débito_card_number | Quatro últimos dígitos do cartão de débito do usuário. | string |
| $flow.debit_card_exp_date | Data de validade do cartão de débito fornecido pelo usuário para o cartão de débito especificado. |
{ |
| $flow.debit_card_cvv_code | Código CVV fornecido pelo usuário para o cartão de débito especificado. | string |
| $flow.payment_amount | É o valor que o usuário optou por pagar. | number |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| payment_status_code | Indica se o pagamento foi bem-sucedido. Os valores válidos são definidos pelos parâmetros de entrada configuráveis $flow.payment_success_code, $flow.insufficient_fund_code e $flow.limit_exceed_code. |
string |
Para configurar o webhook "Processar pagamento com cartão de débito" para este componente, abra as instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_make_a_payment:process_payment_ confidenciais_card.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Processar pagamento da conta
O webhook prebuilt_components_make_a_payment:process_payment_account
é usado pelo componente para processar um pagamento usando os detalhes da conta fornecidos.
Parâmetros de solicitação de API
Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| $flow.payee_number | Quatro últimos dígitos do número da conta do beneficiário para o pagamento. | string |
| $flow.payment_type | Tipo de pagamento. Os valores válidos são definidos pela entidade personalizada prebuilt_components_make_a_payment_payment_type. Por padrão, este componente oferece suporte a "beneficiary_pay" e "credit_card_pay". |
string |
| $session.params.last_four_digit_of_account_number | Últimos quatro dígitos da conta do usuário. | string |
| $flow.payment_amount | É o valor que o usuário optou por pagar. | number |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| payment_status_code | Indica se o pagamento foi bem-sucedido. Os valores válidos são definidos pelos parâmetros de entrada configuráveis $flow.payment_success_code, $flow.insufficient_fund_code e $flow.limit_exceed_code. |
string |
Para configurar o webhook de pagamento da conta do processo para este componente, abra as instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_make_a_payment:process_payment_account.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Processar pagamento pelo dispositivo móvel
O webhook prebuilt_components_make_a_payment:process_payment_mobile
é usado pelo componente para gerar e enviar um link de pagamento para dispositivos móveis referente aos
detalhes do usuário selecionados.
Parâmetros de solicitação de API
Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| $flow.payee_number | Quatro últimos dígitos do número da conta do beneficiário para o pagamento. | string |
| $flow.payment_type | Tipo de pagamento. Os valores válidos são definidos pela entidade personalizada prebuilt_components_make_a_payment_payment_type. Por padrão, este componente oferece suporte a "beneficiary_pay" e "credit_card_pay". |
string |
| $flow.payment_amount | É o valor que o usuário optou por pagar. | number |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| payment_link_generated | Indica se o link de pagamento móvel foi gerado e enviado ao usuário. | boolean |
Para configurar o webhook de pagamento para dispositivos móveis deste componente, abra as instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_make_a_payment:process_payment_mobile.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Concluído
Seu agente e os webhooks dele agora estão configurados e prontos para teste.