A opção para efetuar um pagamento componente pré-criado autentica o usuário e permite que ele faça um pagamento. Esse componente usa uma versão personalizada do Autenticação pré-criado para autenticar titulares de contas e titulares de cartões. O componente também use a Coleção de nomes, Coleta da data de validade do cartão de crédito, e Coleta de CVV do cartão de crédito componentes pré-criados para coletar informações necessárias para fazer pagamentos.
Tipos de pagamento
Esse componente é compatível com pagamentos de faturas de cartão de crédito e contas de beneficiários. Para faturas de cartão de crédito, os usuários podem optar por pagar o valor mínimo, total ou um valor na fatura. O usuário pode fazer pagamentos de sua conta bancária, cartão de débito, crédito ou pagamento com celular.
| 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 dispositivo móvel | Mínimo, total e valor personalizado |
| Conta do beneficiário | Conta bancária, cartão de crédito, cartão de débito, pagamento com dispositivo móvel | Valor personalizado |
Limitações
Além da seção limitações comuns de componentes pré-criados, esse componente pré-criado tem as seguintes limitações:
- Este componente não criptografa dados.
Exemplos de diálogos
Os exemplos de caixas de diálogo a seguir demonstram cenários comuns tratados por este um 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 a 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 coleta informações para verificar se o usuário é um usuário registrado. O usuário indique que gostaria de efetuar um pagamento a uma conta de beneficiário e a de segurança coleta as informações necessárias, incluindo o nome do beneficiário, e confirma a o número da conta de serviço. Por fim, o usuário opta por 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 CSC e confirma o pagamento.
| Entrada do usuário | Resposta do agente |
|---|---|
| O agente autentica o usuário com o componente pré-criado do Authentication | |
| 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 existente? | |
| Beneficiário | |
| O agente coleta o nome do beneficiário usando o componente pré-criado Coleta 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ê quer pagar US $100,30, digamos 100 ponto 30. | |
| 50 dólares | |
| Quer pagar com conta bancária, cartão de débito, cartão de crédito ou pagamento com dispositivo móvel? | |
| Débito | |
| Informe os quatro últimos 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, correto? | |
| Sim, é isso mesmo | |
| O agente coleta a data de validade do cartão de débito usando o componente pré-criado Coleta de 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 Coleção CVV do cartão de crédito | |
| Ótimo, terminamos de coletar o CVV. | |
| Ok, vamos fazer um pagamento de $50 para Jane com o número do cartão de débito com final 1234. Você confirma essa ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Prefere receber o código por telefone ou e-mail? | |
| Envie um e-mail, por favor | |
| Enviamos um código para seu e-mail registrado joao.silva@google.com. Isso pode levar alguns segundos. Você pode confirmar o código? | |
| 123456 | |
| Certo. Aguarde alguns segundos enquanto efetuamos o pagamento. O pagamento da sua conta de beneficiário foi concluído. |
Pagamento de fatura com 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 é um usuário registrado. O usuário indica que o cliente gostaria de efetuar um pagamento na fatura do cartão de crédito usando a conta bancária. O agente confirma o valor e a forma de pagamento. e conclui o pagamento.
| Entrada do usuário | Resposta do agente |
|---|---|
| O agente autentica o usuário com o componente pré-criado do Authentication | |
| 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 existente? | |
| Fatura do cartão de crédito | |
| Informe os quatro últimos 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 R $300,00 e o pagamento mínimo é de R $20,00. Quer pagar o valor total, mínimo ou qualquer outra quantia? | |
| Valor total | |
| Você quer pagar com conta bancária, cartão de débito ou pagamento com dispositivo móvel? | |
| Conta poupança | |
| Descobrimos que há duas contas associadas ao seu número. Informe os quatro últimos dígitos da conta a que você se refere. | |
| 1001 | |
| Os últimos quatro dígitos do número da conta que obtemos são 1001, correto? | |
| Sim | |
| Ok, vamos fazer um pagamento de $300 para a fatura do seu cartão de crédito com final 4321 e o número da conta termina em 1001. Você confirma essa 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 seu e-mail registrado joao.silva@google.com. Isso pode levar alguns segundos. Você pode confirmar o código? | |
| 123456 | |
| Ok. Aguarde alguns segundos enquanto efetuamos o pagamento. O pagamento com seu 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 é um usuário registrado. O usuário tenta fazer pagamentos na fatura do cartão de crédito usando a conta bancária e cartão de débito, mas os dois pagamentos forem recusados devido a fundos insuficientes limites. Por fim, o usuário opta por fazer um pagamento por 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 com o componente pré-criado do Authentication | |
| 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 existente? | |
| Cartão de crédito | |
| Informe os quatro últimos 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 R $300,00 e o pagamento mínimo é de R $20,00. Quer pagar o valor total, mínimo ou qualquer outra quantia? | |
| Valor total | |
| Você quer pagar com conta bancária, cartão de débito ou pagamento com dispositivo móvel? | |
| Poupança | |
| Descobrimos que há duas contas associadas ao seu número. Informe os quatro últimos dígitos da conta a que você se refere. | |
| 1002 | |
| Os últimos quatro dígitos do número da conta que obtemos são 1002, correto? | |
| Sim | |
| Ok, vamos fazer um pagamento de $300 para a fatura do seu cartão de crédito com final 4321 e o número da conta com final 1002. Você confirma essa 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 seu e-mail registrado joao.silva@google.com. Isso pode levar alguns segundos. Você pode confirmar o código? | |
| 123456 | |
| Certo. Aguarde alguns segundos enquanto efetuamos o pagamento. Não foi possível concluir o pagamento porque você não tem saldo suficiente na conta. Quer tentar pagar de novo com outra forma de pagamento? |
|
| Sim | |
| Você quer pagar com conta bancária, cartão de débito ou pagamento com dispositivo móvel? | |
| Cartão de débito | |
| Informe os quatro últimos 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, correto? | |
| Sim | |
| O agente coleta a data de validade do cartão de débito usando o componente pré-criado Coleta de 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 Coleção CVV do cartão de crédito | |
| Ótimo, terminamos de coletar o CVV. | |
| Ok, vamos fazer um pagamento de $300 para a fatura do seu cartão de crédito com final 4321 e o número do cartão de débito com final 2345. Você confirma essa 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 seu e-mail registrado joao.silva@google.com. Isso pode levar alguns segundos. Você pode confirmar o código? | |
| 123456 | |
| Certo. Aguarde alguns segundos enquanto fazemos o pagamento. Ocorreu uma falha no pagamento porque o limite do cartão de débito foi excedido. Quer tentar pagar de novo com outra forma de pagamento? |
|
| Sim | |
| Você quer pagar com conta bancária, cartão de débito ou pagamento com dispositivo móvel? | |
| Dispositivo móvel | |
| Certo, estamos enviando o link de pagamento para seu número de celular registrado. Isso pode levar alguns segundos. Confirme dizendo "sim", caso tenha recebido. | |
| Sim | |
| Ótimo! Agora você pode abrir o link e continuar o pagamento. |
Convenções de nomenclatura
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
Parâmetros de entrada são parâmetros usados para configurar certos comportamentos de do componente. Os parâmetros serão usados por uma ou mais condições dentro do para determinar como o componente deve se comportar. Os parâmetros com escopo de fluxo precisam ser definido na página inicial do componente, conforme descrito abaixo. No escopo da sessão podem ser definidos por um fluxo de chamada ou no início página 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âmetro do fulfillment de entrada de página na check auth level página. Por padrão, esse valor é 1. |
integer |
| $session.params.account_auth_enabled | Indica se o usuário deve ser autenticado como proprietário de uma conta, conforme descrito em Tipos de autenticação. Esse valor é configurado nas predefinições de parâmetro do fulfillment de entrada de página na check auth level página. 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âmetro do fulfillment de entrada de página na check auth level página. 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 bem-sucedido. 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 não foi possível concluir o pagamento 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 não foi possível concluir o pagamento 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 tem permissão para 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 efetuar 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 efetuar um pagamento usando o pagamento com dispositivo móvel. 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 da 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 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 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 ao agente para aguardar enquanto recebe o link para pagamento em dispositivo móvel. O valor padrão é 2. |
integer |
Para configurar os parâmetros de entrada deste 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 Predefinições de parâmetro conforme necessário.
- Clique em Salvar.
Parâmetros de saída
Os parâmetros de saída são de sessão que permanecerão ativos depois de sair. do componente. Esses parâmetros contêm informações importantes coletadas pelo componente. Esse componente pré-criado fornece valores para a saída a seguir parâmetros:
| 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 da saída do fluxo, caso não tenha 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 recusou o compartilhamento de informações solicitadas pelo componente.max_no_input: a conversa atingiu o número máximo de novas tentativas para eventos sem entrada. Confira 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 o evento integrado webhook.error. webhook_not_found: um URL de webhook estava inacessível. Consulte 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 com que descreve os serviços externos do Dialogflow, consulte Webhook configuração abaixo.
Configuração do webhook
Para usar este componente, você precisa configurar o webhooks flexíveis para recuperar informações necessárias dos serviços externos.
Autenticação
Se você não configurou os serviços externos necessários para você precisará configurá-los para ativar a autenticação de usuários para esse componente. Consulte Configuração do 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 existe uma conta com base nas informações
número de telefone registrado e os ú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 para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| account_found | Indica se uma conta com os últimos quatro dígitos fornecidos existe para a conta registrada do usuário. | booleano |
| saldo | O valor do saldo atual da conta, se houver. | number |
Para configurar o webhook da conta "Validar a conta" para este componente, expanda para conferir 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 com que você quer fazer a integração. 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 do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Detalhes do card de usuário
O webhook prebuilt_components_make_a_payment:user_card_details é usado
pelo componente para obter 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 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 card 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 Webhook URL do Dialogflow pelo endpoint do serviço com que você quer fazer a integração. 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 do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise 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 existe uma conta de beneficiário para o nome
fornecidas 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 para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| beneficiary_account_number | Os últimos quatro dígitos do número da conta do beneficiário fornecido no nome do beneficiário. Se a conta de um beneficiário não for encontrada, o valor será null. |
string |
Para configurar o webhook "Verificar nome do beneficiário" 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:verify_beneficiary_name.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço com que você quer fazer a integração. 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 do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Receber valor devido
O webhook prebuilt_components_make_a_payment:get_due_amount é usado
pelo componente para obter informações sobre o valor mínimo e total devido
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 | Ú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 "Receber valor devido" para esse componente, expanda para conferir 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 com que você quer fazer a integração. 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 do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise 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 do cartão de crédito fornecido está registrado
à 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 | Ú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 fornecido foi encontrado. | booleano |
Para configurar o webhook "Verificar número do cartão de crédito" para esse 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 com que você quer fazer a integração. 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 do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise 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
para verificar se os detalhes fornecidos, incluindo a data de validade
e o CSC são válidos para o cartão de crédito informado.
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 | Últimos quatro dígitos do cartão de crédito do usuário. | string |
| $flow.credit_card_exp_date | A data de validade informada pelo usuário para o cartão de crédito específico. | { |
| $flow.credit_card_cvv_code | Código de segurança do cartão (CSC) 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 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 informados foram validados. | booleano |
Para configurar o webhook "Verificar detalhes do cartão de crédito" 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:verify_credit_card_details.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço com que você quer fazer a integração. 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 do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise 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
para verificar se os detalhes fornecidos, incluindo a data de validade
e o CSC são válidos para o cartão de débito informado.
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.debit_card_number | Últimos quatro dígitos do cartão de débito do usuário. | string |
| $flow.debit_card_exp_date | A data de validade do cartão de débito especificado pelo usuário. | { |
| $flow.debit_card_cvv_code | Código de segurança do cartão (CSC) 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 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 fornecido foram validados. | booleano |
Para configurar o webhook "Verificar detalhes do cartão de débito" 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:verify_ debit_card_details.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço com que você quer fazer a integração. 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 do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise 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 de 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 | Ú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 | A data de validade do cartão de crédito especificado pelo usuário. | { |
| $flow.credit_card_cvv_code | Código de segurança do cartão (CSC) 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 para serem usados 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 pagamentos com cartão de crédito" 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:process_payment_credit_card.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço com que você quer fazer a integração. 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 do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise 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, utilizado 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 | A data de validade do cartão de débito especificado pelo usuário. | { |
| $flow.debit_card_cvv_code | Código de segurança do cartão (CSC) 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 para serem usados 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 pagamentos com cartão de débito" 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:process_payment_débito_card.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço com que você quer fazer a integração. 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 do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Processar o pagamento da conta
O webhook prebuilt_components_make_a_payment:process_payment_account
é usado pelo componente para processar um pagamento usando os detalhes de 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 | Ú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 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 da conta" para esse 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:process_payment_account.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço com que você quer fazer a integração. 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 do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Processar pagamento com dispositivo móvel
O webhook prebuilt_components_make_a_payment:process_payment_mobile
é usado pelo componente para gerar e enviar um link de pagamento no celular para o
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, utilizado 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 no dispositivo móvel foi gerado e enviado ao usuário. | booleano |
Para configurar o webhook "Processar pagamento para dispositivos móveis" 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:process_payment_mobile.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço com que você quer fazer a integração. 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 do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Concluído
Seu agente e os respectivos webhooks devem estar configurados e prontos para teste.