Criar um componente pré-criado de pagamento

O componente pré-criado fazer um pagamento autentica o usuário e permite que ele faça um pagamento. Esse componente usa uma versão personalizada do componente Authentication pré-criado para autenticar titulares de contas e de cartões. O componente também usa os componentes pré-criados Coleta de nome, Coleta de data de validade do cartão de crédito e Coleta 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 faturas de cartão de crédito e contas de beneficiário. Para faturas de cartão de crédito, os usuários podem pagar o valor mínimo, total ou um valor 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 móvel	Valor personalizado

Limitações

Além das limitações comuns dos componentes pré-criados, este componente pré-criado tem as seguintes limitações:

• Esse componente não criptografa nenhum dado.

Diálogos de exemplo

As caixas de diálogo de exemplo a seguir demonstram cenários comuns processados por esse componente pré-criado. Os diálogos 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 antes e coleta informações para verificar se ele é um usuário registrado. O usuário indica que quer fazer um pagamento para uma conta beneficiária, 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 fazer um pagamento com o cartão de débito. Assim, o agente coleta 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 foi concluída.
	Você quer pagar a fatura do cartão de crédito registrado ou fazer um pagamento para uma conta beneficiária?
Beneficiário
	O agente coleta o nome do beneficiário usando o componente pré-criado Coleta de nome
	Agradecemos. Coletamos o nome do beneficiário. Ok, 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 "cem ponto trinta".
50 dólares
	Quer pagar com conta bancária, cartão de débito, crédito ou pagamento móvel?
Débito
	Você pode nos informar 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. Isso está 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, terminamos de coletar a 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 de CVV de cartão de crédito
	Ótimo, terminamos de coletar o CVV.
	Ok, vamos fazer um pagamento de $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 seu e-mail registrado [e-mail]. Isso pode levar alguns segundos. Você pode confirmar o código?
123456
	Aguarde alguns segundos enquanto fazemos o pagamento. O pagamento para a conta do beneficiário foi concluído.

Pagamento de fatura do cartão de crédito

O agente identifica que o usuário não foi autenticado antes e coleta informações para verificar se ele está registrado. O usuário indica que quer pagar a fatura do cartão de crédito usando a conta bancária. O representante confirma o valor e os detalhes da forma de pagamento e conclui a transação.

Entrada do usuário	Resposta do agente
	O agente autentica o usuário usando o componente pré-criado Authentication
	Agradecemos. Sua autenticação foi concluída.
	Você quer pagar a fatura do cartão de crédito registrado ou fazer um pagamento para uma conta beneficiária?
Fatura do cartão de crédito
	Você pode nos ajudar com 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 cartão de crédito que recebemos são 4321. Isso está correto?
Sim
	O valor total devido é de US $300, e o pagamento mínimo é de US $20. Você quer pagar o valor total, o valor mínimo ou qualquer outro valor?
Valor total
	Quer pagar com conta bancária, cartão de débito ou pagamento móvel?
Conta poupança
	Encontramos duas contas associadas ao seu número. Você pode nos ajudar com 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. Isso está correto?
Sim
	Ok, vamos fazer um pagamento de $300 para a fatura do seu cartão de crédito com final 4321 e 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 seu e-mail registrado [e-mail]. Isso pode levar alguns segundos. Você pode confirmar o código?
123456
	Aguarde alguns segundos enquanto fazemos o pagamento. O pagamento com cartão de crédito foi concluído.

Saldo ou limites insuficientes

O agente identifica que o usuário não foi autenticado antes e coleta informações para verificar se ele está registrado. O usuário tenta pagar a fatura do cartão de crédito com a conta bancária e o cartão de débito, mas os dois pagamentos são recusados por falta de fundos ou limites. Por fim, o usuário opta por fazer um pagamento 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 foi concluída.
	Você quer pagar a fatura do cartão de crédito registrado ou fazer um pagamento para uma conta beneficiária?
Cartão de crédito
	Você pode nos ajudar com 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 cartão de crédito que recebemos são 4321. Isso está correto?
Sim
	O valor total devido é de US $300, e o pagamento mínimo é de US $20. Você quer pagar o valor total, o valor mínimo ou qualquer outro valor?
Valor total
	Quer pagar com conta bancária, cartão de débito ou pagamento móvel?
Poupança
	Encontramos duas contas associadas ao seu número. Você pode nos ajudar com 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. Isso está correto?
Sim
	Tudo bem. Vamos pagar $300 da fatura do seu cartão de crédito com final 4321 usando a 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?
E-mail
	Enviamos um código para seu e-mail registrado [e-mail]. Isso pode levar alguns segundos. Você pode confirmar o código?
123456
	Aguarde alguns segundos enquanto fazemos o pagamento. Seu pagamento falhou por falta de fundos na conta. Quer tentar de novo com outra forma de pagamento?
Sim
	Quer pagar com conta bancária, cartão de débito ou pagamento móvel?
Cartão de débito
	Você pode nos informar 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. Isso está 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, terminamos de coletar a 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 de CVV de cartão de crédito
	Ótimo, terminamos de coletar o CVV.
	Ok, vamos pagar $300 da fatura do seu cartão de crédito com final 4321 usando o 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?
E-mail
	Enviamos um código para seu e-mail registrado [e-mail]. Isso pode levar alguns segundos. Você pode confirmar o código?
123456
	Aguarde alguns segundos enquanto fazemos o pagamento. Seu pagamento falhou porque o limite do cartão de débito foi excedido. Quer tentar de novo com outra forma de pagamento?
Sim
	Quer pagar com conta bancária, cartão de débito ou pagamento móvel?
Dispositivo móvel
	OK, estamos enviando o link de pagamento para seu 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 pré-criado 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 deve 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 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 caller.	integer
$session.params.auth_level_req	Indica o nível de autenticação necessário para que um usuário acesse 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 com sucesso. 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 por falta de fundos. 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 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 mudar 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 o pagamento móvel como forma de pagamento. O valor padrão é 2.	integer
$flow.max_retry_creditcard_count	Especifica o número de 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 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 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 móvel. O valor padrão é 2.	integer

Para configurar os parâmetros de entrada desse componente, expanda para instruções.

1. Abra o console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Selecione a guia Build.
5. Clique no componente importado na seção Fluxos.
6. Clique em "Página inicial" na seção Páginas.
7. Clique na rota true na página inicial.
8. Na janela "Rota", edite os valores de Predefinições de parâmetros conforme necessário.
9. Clique em Salvar.

Parâmetros de saída

Os parâmetros de saída são parâmetros de sessão que permanecem ativos depois de sair 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, usado para identificar o usuário.	string
transfer_reason	Esse parâmetro indica o motivo da saída do fluxo, caso ele não tenha sido concluído. 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 se recusou 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 de não correspondência. webhook_error: ocorreu um erro de webhook. Consulte 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:

1. Importe o componente pré-criado.
2. Configure os webhooks flexíveis fornecidos com uma configuração que descreve seus serviços externos. Consulte a configuração de webhook abaixo.

Configuração do webhook

Para usar esse componente, configure os webhooks flexíveis incluídos para recuperar as informações necessárias dos seus serviços externos.

Autenticação

Se você ainda não tiver configurado os serviços externos necessários para autenticação, faça isso para ativar a autenticação de usuários para esse 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 quatro últimos 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, 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 quatro últimos dígitos fornecidos para a conta registrada do usuário.	booleano
saldo	O valor do saldo atual na conta, se existir.	número

Para configurar o webhook "Validar conta" para esse componente, expanda para ver as instruções.

1. Abra o console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Selecione a guia Gerenciar.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_account_services:validate_account.
7. Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
8. Revise e atualize o corpo da solicitação para formar o formato adequado para seu webhook.
9. 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 necessários para que o componente acesse os valores dos campos retornados.
10. Revise e atualize as configurações de Autenticação conforme necessário.
11. Clique em Salvar.

Detalhes do card de 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	Os ú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	Os ú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 de usuário para esse componente, abra as instruções.

1. Abra o console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Selecione a guia Gerenciar.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_make_a_payment:user_card_details.
7. Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
8. Revise e atualize o corpo da solicitação para formar o formato adequado para seu webhook.
9. 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 necessários para que o componente acesse os valores dos campos retornados.
10. Revise e atualize as configurações de Autenticação conforme necessário.
11. 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 beneficiária 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 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 quatro últimos dígitos do número da conta do beneficiário para o nome informado. Se uma conta beneficiária com o nome fornecido não for encontrada, o valor será null.	string

Para configurar o webhook "Verificar nome do beneficiário" para esse componente, expanda as instruções.

1. Abra o console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Selecione a guia Gerenciar.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_make_a_payment:verify_beneficiary_name.
7. Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
8. Revise e atualize o corpo da solicitação para formar o formato adequado para seu webhook.
9. 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 necessários para que o componente acesse os valores dos campos retornados.
10. Revise e atualize as configurações de Autenticação conforme necessário.
11. Clique em Salvar.

Receber 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 na 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	Os ú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 especificado.	número
total_amount	Valor total devido na fatura do cartão de crédito especificado.	número

Para configurar o webhook "Get due amount" para esse componente, expanda as instruções.

1. Abra o console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Selecione a guia Gerenciar.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_make_a_payment:get_due_amount.
7. Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
8. Revise e atualize o corpo da solicitação para formar o formato adequado para seu webhook.
9. 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 necessários para que o componente acesse os valores dos campos retornados.
10. Revise e atualize as configurações de Autenticação conforme necessário.
11. 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 informado 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	Os ú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 "Verificar número do cartão de crédito" para esse componente, expanda as instruções.

1. Abra o console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Selecione a guia Gerenciar.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_make_a_payment:verify_credit_card_number.
7. Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
8. Revise e atualize o corpo da solicitação para formar o formato adequado para seu webhook.
9. 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 necessários para que o componente acesse os valores dos campos retornados.
10. Revise e atualize as configurações de Autenticação conforme necessário.
11. 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 data de validade e CVV, são válidos para o cartão de crédito 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, usado para identificar o usuário.	string
$flow.credit_card_number	Os ú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 específico.	{ "year": integer, "month": integer }
$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 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 "Verificar detalhes do cartão de crédito" para esse componente, expanda as instruções.

1. Abra o console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Selecione a guia Gerenciar.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_make_a_payment:verify_credit_card_details.
7. Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
8. Revise e atualize o corpo da solicitação para formar o formato adequado para seu webhook.
9. 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 necessários para que o componente acesse os valores dos campos retornados.
10. Revise e atualize as configurações de Autenticação conforme necessário.
11. 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 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, usado para identificar o usuário.	string
$flow.debit_card_number	Os ú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 fornecida pelo usuário para o cartão especificado.	{ "year": integer, "month": integer }
$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 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 "Verificar detalhes do cartão de débito" para esse componente, abra as instruções.

1. Abra o console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Selecione a guia Gerenciar.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_make_a_payment:verify_debit_card_details.
7. Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
8. Revise e atualize o corpo da solicitação para formar o formato adequado para seu webhook.
9. 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 necessários para que o componente acesse os valores dos campos retornados.
10. Revise e atualize as configurações de Autenticação conforme necessário.
11. 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	Os ú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 é compatível com "beneficiary_pay" e "credit_card_pay".	string
$flow.credit_card_number	Os ú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 especificado.	{ "year": integer, "month": integer }
$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 escolheu pagar.	número

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 "Process credit card payment" (Processar pagamento com cartão de crédito) para esse componente, expanda para ver as instruções.

1. Abra o console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Selecione a guia Gerenciar.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_make_a_payment:process_payment_credit_card.
7. Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
8. Revise e atualize o corpo da solicitação para formar o formato adequado para seu webhook.
9. 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 necessários para que o componente acesse os valores dos campos retornados.
10. Revise e atualize as configurações de Autenticação conforme necessário.
11. 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	Os ú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 é compatível com "beneficiary_pay" e "credit_card_pay".	string
$flow.debit_card_number	Os ú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 fornecida pelo usuário para o cartão especificado.	{ "year": integer, "month": integer }
$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 escolheu pagar.	número

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 "Process debit card payment" (Processar pagamento com cartão de débito) para esse componente, expanda para ver as instruções.

1. Abra o console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Selecione a guia Gerenciar.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_make_a_payment:process_payment_debit_card.
7. Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
8. Revise e atualize o corpo da solicitação para formar o formato adequado para seu webhook.
9. 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 necessários para que o componente acesse os valores dos campos retornados.
10. Revise e atualize as configurações de Autenticação conforme necessário.
11. Clique em Salvar.

Processar pagamento da conta

O webhook prebuilt_components_make_a_payment:process_payment_account é usado pelo componente para processar um pagamento com 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	Os ú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 é compatível com "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 escolheu pagar.	número

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 "Process account payment" para esse componente, expanda para ver as instruções.

1. Abra o console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Selecione a guia Gerenciar.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_make_a_payment:process_payment_account.
7. Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
8. Revise e atualize o corpo da solicitação para formar o formato adequado para seu webhook.
9. 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 necessários para que o componente acesse os valores dos campos retornados.
10. Revise e atualize as configurações de Autenticação conforme necessário.
11. 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 móvel com 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	Os ú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 é compatível com "beneficiary_pay" e "credit_card_pay".	string
$flow.payment_amount	O valor que o usuário escolheu pagar.	número

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 móvel foi gerado e enviado ao usuário.	booleano

Para configurar o webhook "Process mobile payment" (Processar pagamento móvel) para esse componente, expanda para ver as instruções.

1. Abra o console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Selecione a guia Gerenciar.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_make_a_payment:process_payment_mobile.
7. Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
8. Revise e atualize o corpo da solicitação para formar o formato adequado para seu webhook.
9. 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 necessários para que o componente acesse os valores dos campos retornados.
10. Revise e atualize as configurações de Autenticação conforme necessário.
11. Clique em Salvar.

Concluído

Seu agente e os webhooks dele agora estão configurados e prontos para teste.