O componente predefinido de fazer um pagamento autentica o usuário e permite que ele faça um pagamento. Esse componente usa uma versão personalizada do componente pré-criado de autenticação para autenticar titulares de contas e de cartões. O componente também usa os componentes predefinidos Coleção de nome, Coleção de data de validade do cartão de crédito e Coleção de CVV do cartão de crédito para coletar as informações necessárias para fazer pagamentos.
Tipos de pagamento
Esse componente aceita pagamentos de contas de cartão de crédito e contas de beneficiário. Para faturas de cartão de crédito, os usuários podem escolher pagar o valor mínimo, total ou personalizado. O usuário pode fazer pagamentos com a conta bancária, cartão de débito ou 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 com celular | Valor mínimo, total e personalizado |
| Conta do beneficiário | Conta bancária, cartão de crédito, cartão de débito, pagamento por celular | Valor personalizado |
Limitações
Além das limitações comuns de componentes predefinidos, este componente predefinido tem as seguintes limitações:
- Esse componente não criptografa dados.
Exemplos de diálogos
As caixas de diálogo de exemplo a seguir 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 da conta do beneficiário
O agente identifica que o usuário não foi autenticado anteriormente e coleciona informações para verificar se o usuário é registrado. O usuário indica que gostaria de fazer um pagamento para uma conta de 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 a opção de fazer um pagamento usando o cartão de débito. Então, o agente coleta o número do cartão de débito, a data de validade, o CVV e confirma o pagamento.
| Entrada do usuário | Resposta do agente |
|---|---|
| O agente autentica o usuário usando o componente predefinido Authentication | |
| Agradecemos. Sua autenticação foi concluída. | |
| Quer pagar a fatura do cartão de crédito registrado ou fazer um pagamento para uma conta de beneficiário? | |
| Beneficiário | |
| O agente coleta o nome do beneficiário usando o componente predefinido Coleção de nomes | |
| Agradecemos. Coletamos o nome do beneficiário. Com base nos nossos registros, temos o número da conta que termina em 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 ponto 30. | |
| 50 dólares | |
| Quer pagar com sua conta bancária, cartão de débito, cartão de crédito ou pagamento pelo celular? | |
| Débito | |
| Você pode informar os últimos quatro dígitos do número do cartão de débito a que você se refere? | |
| 1234 | |
| Os últimos quatro dígitos do número do cartão de débito que recebemos são 1234, certo? | |
| Sim, está correto | |
| O agente coleta a data de validade do cartão de débito usando o componente predefinido Coleta de data de validade do cartão de crédito | |
| Ótimo, já coletamos a data de validade do cartão de débito. | |
| O agente coleta o CVV do cartão de débito usando o componente predefinido Coleta de CVV do cartão de crédito | |
| Ótimo, já coletamos o CVV. | |
| Vamos fazer um pagamento de US $50 para Jane com o cartão de débito com final 1234. Você confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Você prefere receber o código por telefone ou e-mail? | |
| Por e-mail, por favor | |
| 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. O pagamento na conta do beneficiário foi concluído. |
Pagamento de fatura de cartão de crédito
O agente identifica que o usuário não foi autenticado anteriormente e coleciona informações para verificar se o usuário é registrado. O usuário indica que gostaria de fazer um pagamento da fatura do cartão de crédito usando a conta bancária. O agente confirma o valor do pagamento 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 predefinido Authentication | |
| Agradecemos. Sua autenticação foi concluída. | |
| Quer pagar a fatura do cartão de crédito registrado ou fazer um pagamento para uma conta de beneficiário? | |
| Fatura do cartão de crédito | |
| Você pode informar 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, certo? | |
| Sim | |
| O valor total a pagar é de R $300, e o pagamento mínimo é de R $20. Você quer pagar o valor total, o valor mínimo ou qualquer outro valor? | |
| Valor total | |
| Você quer pagar com sua conta bancária, cartão de débito ou pagamento por celular? | |
| Conta poupança | |
| Descobrimos que há duas contas associadas ao seu número. Você pode nos informar os últimos quatro dígitos da conta a que você se refere? | |
| 1001 | |
| Os últimos quatro dígitos do número da conta que recebemos são 1001, certo? | |
| Sim | |
| Vamos fazer um pagamento de US $300 para a fatura do seu cartão de crédito com final 4321 e o número da conta com final 1001. Você confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Você 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 | |
| Ok, aguarde alguns segundos enquanto fazemos o pagamento. O pagamento com cartão de crédito foi concluído. |
Limites ou fundos insuficientes
O agente identifica que o usuário não foi autenticado anteriormente e coleciona informações para verificar se o usuário é registrado. O usuário tenta fazer pagamentos da fatura do cartão de crédito usando a conta bancária e o cartão de débito, mas ambos os pagamentos são recusados devido a fundos ou limites insuficientes. Por fim, o usuário opta por fazer um pagamento pelo celular, e o agente envia um link para concluir o pagamento pelo celular.
| Entrada do usuário | Resposta do agente |
|---|---|
| O agente autentica o usuário usando o componente predefinido Authentication | |
| Agradecemos. Sua autenticação foi concluída. | |
| Quer pagar a fatura do cartão de crédito registrado ou fazer um pagamento para uma conta de beneficiário? | |
| Cartão de crédito | |
| Você pode informar 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, certo? | |
| Sim | |
| O valor total a pagar é de R $300, e o pagamento mínimo é de R $20. Você quer pagar o valor total, o valor mínimo ou qualquer outro valor? | |
| Valor total | |
| Você quer pagar com sua conta bancária, cartão de débito ou pagamento por celular? | |
| Poupança | |
| Descobrimos que há duas contas associadas ao seu número. Você pode nos informar os últimos quatro dígitos da conta a que você se refere? | |
| 1002 | |
| Os últimos quatro dígitos do número da conta que recebemos são 1002, certo? | |
| Sim | |
| Vamos fazer um pagamento de US $300 para a fatura do cartão de crédito com final 4321 e o número da conta com final 1002. Você confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Você 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. O pagamento falhou devido ao saldo insuficiente na conta. Você quer tentar o pagamento com outra forma de pagamento? |
|
| Sim | |
| Você quer pagar com sua conta bancária, cartão de débito ou pagamento por celular? | |
| Cartão de débito | |
| Você pode informar os últimos quatro dígitos do número do cartão de débito a que você se refere? | |
| 2345 | |
| Os últimos quatro dígitos do número do cartão de débito que recebemos são 2345, certo? | |
| Sim | |
| O agente coleta a data de validade do cartão de débito usando o componente predefinido Coleta de data de validade do cartão de crédito | |
| Ótimo, já coletamos a data de validade do cartão de débito. | |
| O agente coleta o CVV do cartão de débito usando o componente predefinido Coleta de CVV do cartão de crédito | |
| Ótimo, já coletamos o CVV. | |
| Vamos fazer um pagamento de US $300 para a fatura do cartão de crédito com final 4321 e o número do cartão de débito com final 2345. Você confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Você 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. O pagamento falhou porque o limite do cartão de débito foi excedido. Você quer tentar o pagamento com outra forma de pagamento? |
|
| Sim | |
| Você quer pagar com sua conta bancária, cartão de débito ou pagamento por celular? | |
| Dispositivo móvel | |
| Vamos enviar o link de pagamento para o número de celular registrado. Essa ação pode levar alguns segundos. Confirme dizendo "sim" se você recebeu. | |
| Sim | |
| Ótimo, agora você pode abrir o link e continuar o pagamento. |
Convenções de nomenclatura
Esse componente predefinido usa as seguintes convenções de nomenclatura:
| Recurso | Formato | Exemplo |
|---|---|---|
| Fluxo | [Nome do componente] | Fazer 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 serão usados por uma ou mais condições no fluxo para determinar como o componente vai se comportar. Os parâmetros no escopo do 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 do componente.
Esse componente predefinido 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 precisa ser autenticado como titular 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. |
booleano |
| $session.params.card_auth_enabled | Indica se o usuário precisa 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. |
booleano |
| $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 concluído. 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 foi 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 pode ser concluído devido ao limite diário ter sido excedido. Por padrão, esse
valor é "401". |
string |
| $flow.max_retry_mop_counter | Especifica o número de vezes que um usuário pode mudar o método 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 o pagamento por dispositivos móveis como método 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 de cartão de crédito válido para fazer um pagamento. O valor padrão é 3. |
integer |
| $flow.max_retry_acc_number | Especifica o número de novas tentativas permitidas ao coletar detalhes de conta válidos para fazer um pagamento. O valor padrão é 3. |
integer |
| $flow.max_retry_debit_card_details | Especifica o número de novas tentativas permitidas ao coletar detalhes de cartão de débito válidos 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 de cartão de crédito válidos 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 novas 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 para o agente esperar enquanto recebe o link para pagamento por dispositivo móvel. O valor padrão é 2. |
integer |
Para configurar os parâmetros de entrada desse componente, abra 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 das configurações predefinidas de parâmetros conforme necessário.
- Clique em Salvar.
Parâmetros de saída
Os parâmetros de saída são parâmetros de sessão que permanecem ativos após a saída do componente. Esses parâmetros contêm informações importantes coletadas pelo componente. Esse componente predefinido 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, usado para identificar o usuário. | string |
| transfer_reason | Esse parâmetro indica o motivo da saída do fluxo, se não foi bem-sucedido. O valor retornado é um destes:agent: o usuário final solicitou um agente humano em algum momento durante a conversa.denial_of_information: o usuário final recusou-se a compartilhar as informações solicitadas pelo componente.max_no_input: a conversa atingiu o número máximo de novas tentativas para eventos sem entrada. Consulte Eventos integrados sem entrada.max_no_match: a conversa atingiu o número máximo de novas tentativas para eventos sem correspondência. Consulte Eventos integrados sem correspondência.webhook_error: ocorreu um erro de webhook. Consulte webhook.error built-in event. webhook_not_found: um URL de webhook não pode ser acessado. Consulte Webhook.error.not-found built-in event. |
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 seus serviços externos. Consulte a configuração de webhook abaixo.
Configuração do webhook
Para usar esse componente, você precisa configurar os webhooks flexíveis incluídos para extrair as informações necessárias dos seus serviços externos.
Autenticação
Se você não tiver configurado os serviços externos necessários para a autenticação, será necessário fazer isso para ativar a autenticação de usuários para esse componente. Consulte Configuração de webhook de autenticação para ver 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 de 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, usado 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 fazer um pagamento. | string |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API para serem usados 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 informados para a conta registrada do usuário. | booleano |
| saldo | O valor do saldo atual da conta, se houver. | number |
Para configurar o webhook de validação de conta para esse 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 URL do webhook dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de autenticação conforme necessário.
- Clique em Salvar.
Detalhes do cartão do usuário
O webhook prebuilt_components_make_a_payment:user_card_details é usado
pelo componente para receber 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, usado 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 para serem usados 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 | Últimos quatro 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 | Últimos quatro 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 cartão do usuário para esse 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 URL do webhook dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de autenticação conforme necessário.
- Clique em Salvar.
Verificar o nome do beneficiário
O webhook prebuilt_components_make_a_payment:verify_beneficiary_name é usado
pelo componente para verificar se uma conta de beneficiário existe 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, usado 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 beneficiário. | string |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| beneficiary_account_number | Últimos quatro dígitos do número da conta do beneficiário para o nome do beneficiário fornecido. Se não for encontrada uma conta de beneficiário para o nome fornecido, o valor será null. |
string |
Para configurar o webhook de verificação do nome do beneficiário para esse 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_beneficiary_name.
- Substitua o URL no campo URL do webhook dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de autenticação conforme necessário.
- Clique em Salvar.
Receber o valor devido
O webhook prebuilt_components_make_a_payment:get_due_amount é usado
pelo componente para receber informações sobre o valor mínimo e total devido para
a 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, usado para identificar o usuário. | string |
| $flow.user_credit_card_number | Últimos quatro 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 para serem usados 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 "Get due amount" 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:get_due_amount.
- Substitua o URL no campo URL do webhook dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de autenticação conforme necessário.
- Clique em Salvar.
Verificar o 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 de 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, usado para identificar o usuário. | string |
| $flow.user_credit_card_number | Últimos quatro 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 para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| card_found | Indica se o cartão de crédito informado foi encontrado. | booleano |
Para configurar o webhook de verificação do número do 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:verify_credit_card_number.
- Substitua o URL no campo URL do webhook dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de autenticação conforme necessário.
- Clique em Salvar.
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 a data de validade
e o CVV, 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, usado para identificar o usuário. | string |
| $flow.credit_card_number | Últimos quatro 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 fornecida pelo usuário para o cartão de crédito específico. | { |
| $flow.credit_card_cvv_code | O usuário forneceu o código CVV do 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 para serem usados 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. | booleano |
Para configurar o webhook de verificação dos detalhes do cartão de crédito para esse 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_credit_card_details.
- Substitua o URL no campo URL do webhook dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de autenticação conforme necessário.
- Clique em Salvar.
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 a data de validade
e o CVV, são válidos para o cartão de débito 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, usado para identificar o usuário. | string |
| $flow.debit_card_number | Últimos quatro 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 especificada pelo usuário. | { |
| $flow.debit_card_cvv_code | O usuário forneceu o código CVV do 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 para serem usados 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. | booleano |
Para configurar o webhook de verificação de detalhes do cartão de débito para esse 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_debit_card_details.
- Substitua o URL no campo URL do webhook dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de autenticação conforme necessário.
- Clique em Salvar.
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, usado para identificar o usuário. | string |
| $flow.payee_number | Últimos quatro 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, esse componente oferece suporte a "beneficiary_pay" e "credit_card_pay". |
string |
| $flow.credit_card_number | Últimos quatro 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 fornecida pelo usuário para o cartão de crédito especificado. | { |
| $flow.credit_card_cvv_code | O usuário forneceu o código CVV do 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 para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| payment_status_code | Indica se o pagamento foi concluído. 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 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 URL do webhook dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de autenticação conforme necessário.
- Clique em Salvar.
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, usado para identificar o usuário. | string |
| $flow.payee_number | Últimos quatro 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, esse componente oferece suporte a "beneficiary_pay" e "credit_card_pay". |
string |
| $flow.debit_card_number | Últimos quatro 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 especificada pelo usuário. | { |
| $flow.debit_card_cvv_code | O usuário forneceu o código CVV do 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 para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| payment_status_code | Indica se o pagamento foi concluído. 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 com cartão de débito para esse 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_debit_card.
- Substitua o URL no campo URL do webhook dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de autenticação conforme necessário.
- Clique em Salvar.
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, usado para identificar o usuário. | string |
| $flow.payee_number | Últimos quatro 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, esse 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 para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| payment_status_code | Indica se o pagamento foi concluído. 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 de processamento 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 URL do webhook dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de autenticação conforme necessário.
- Clique em Salvar.
Processar pagamentos com dispositivos móveis
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 para os
detalhes de pagamento selecionados 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, usado para identificar o usuário. | string |
| $flow.payee_number | Últimos quatro 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, esse 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 para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| payment_link_generated | Indica se o link de pagamento para dispositivos móveis foi gerado e enviado ao usuário. | booleano |
Para configurar o webhook de processamento de pagamentos móveis para esse 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 URL do webhook dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de autenticação conforme necessário.
- Clique em Salvar.
Concluído
Seu agente e os webhooks dele estão configurados e prontos para testes.