Pular para o conteúdo principal
Depois de conectada a integração, o nó do Conekta fica disponível no Canvas e permite criar experiências de cobrança com WebView incorporado ou confirmação externa dentro do fluxo conversacional.
Se você ainda não instalou a integração, siga primeiro Conectar no Brain Studio.

Adicionar o nó ao Canvas

1

Abrir seu fluxo no Canvas

Abra no Brain Studio o fluxo onde deseja incorporar a cobrança com Conekta.
2

Adicionar o nó Conekta

Adicione Conekta na barra de ferramentas do Canvas, no nó Pagamentos, ou a partir dos provedores de pagamento disponíveis depois que a integração estiver instalada.O ponto exato pode variar conforme você iniciou a instalação pelo Marketplace, Jelou Agent, nó Pagamentos no Canvas ou um template.
3

Conectar o nó ao ponto de cobrança

Conecte o nó do Conekta depois que o fluxo já tiver o valor e a confirmação de compra.
4

Abrir o painel de configuração

Selecione o nó para abrir o painel lateral direito e completar os inputs e revisar as saídas disponíveis.
Nó Conekta no Canvas com saídas de pagamento e painel lateral na aba Dados do pagamento com Personalização desativada

Nó Conekta no Canvas com o painel lateral aberto em Dados do pagamento


Configurar o nó

Dados do pagamento

boolean
padrão:"false"
Ative para definir as mensagens que acompanham o botão de pagamento na conversação.Se estiver desativada, o Brain Studio usa os textos padrão da mensagem de cobrança.
string
Título da mensagem do botão de pagamento.Exibido quando Personalização está ativa. Aparece na visualização prévia da mensagem.
string
Texto principal da mensagem do botão de pagamento.Exibido quando Personalização está ativa. Aparece na visualização prévia da mensagem.
string
Texto de encerramento da mensagem do botão de pagamento.Exibido quando Personalização está ativa. Aparece na visualização prévia da mensagem.
string
obrigatório
Texto descritivo da cobrança. Exemplos: número do pedido, produto, serviço ou referência interna.Você pode mapeá-lo a partir de variáveis do fluxo, por exemplo {{$memory.paymentBreakdown.summary}}.
number
obrigatório
Valor sobre o qual se aplica IVA. Apenas números.Você pode mapeá-lo a partir de variáveis do fluxo.
number
obrigatório
Valor isento de impostos. Se não se aplicar, use 0. Apenas números.Você pode mapeá-lo a partir de variáveis do fluxo.
string
Nome da pessoa ou razão social da empresa titular do pagamento.Aplica-se quando a Experiência de pagamento é Pagamento Confirmação Externa. Se o fluxo não o enviar, o agente conversacional pede diretamente ao pagador.
string
Sobrenome da pessoa titular do pagamento.Aplica-se quando a Experiência de pagamento é Pagamento Confirmação Externa.
string
O campo aparece no nó porque é compartilhado com o Wompi, mas o Conekta não o usa: você pode deixá-lo vazio. O agente também não o solicita ao pagador.
string
E-mail do titular do pagamento.Aplica-se quando a Experiência de pagamento é Pagamento Confirmação Externa.
Painel lateral do nó Conekta na aba Dados do pagamento com Personalização ativa, campos Cabeçalho, Conteúdo, Rodapé, visualização prévia da mensagem e valores da cobrança

Dados do pagamento com personalização do botão ativa

Painel lateral do nó Conekta na aba Dados do pagamento mostrando os campos Nome do titular, Sobrenome do titular, Número de documento ou NIT e E-mail

Dados do pagamento com a Experiência de pagamento Confirmação Externa: campos Nome do titular, Sobrenome do titular, Número de documento ou NIT e E-mail

Com Personalização desativada, o painel mostra diretamente os campos da cobrança. O nó no Canvas expõe as saídas Pagamento bem-sucedido, Pagamento pendente, Mensagem de pagamento enviada, Pagamento falhou e Erro.

Avançado

O bloco Ambiente mostra se o Conekta opera em Desenvolvimento ou Produção.Se a integração estiver em Desenvolvimento, a partir daí você pode iniciar o fluxo Passar para produção.Se a integração estiver em Produção, o bloco reflete que o Conekta já opera com credenciais produtivas.
O ambiente depende das credenciais instaladas. Não passe para produção sem preparar credenciais produtivas.
string
obrigatório
Define como o pagador conclui a transação. Opções disponíveis:
  • Pagamento WebView — abre o checkout do Conekta como WebView incorporado dentro da conversa.
  • Pagamento Confirmação Externa — um agente conversacional guia o pagador para concluir o pagamento por aprovação no app BBVA Wallet ou código SPEI, fora do WhatsApp.
Nó Conekta na aba Avançado mostrando o campo Experiência de pagamento com as opções Pagamento WebView e Pagamento Confirmação Externa

Campo Experiência de pagamento na aba Avançado do nó Conekta

number
Define por quanto tempo o botão de pagamento permanece válido após ser enviado.Os valores disponíveis dependem da configuração visível no Brain Studio.
string
obrigatório
Define a moeda da cobrança.Para Conekta México, normalmente você usará MXN.
number
Define o percentual de IVA aplicado à operação de cobrança.
string
Campo opcional para guardar referência interna como ID do pedido, correlativo, user ID ou booking ID.
string
Define o nome da variável de memória onde o Brain Studio armazenará a resposta do nó.A resposta ficará disponível em nós posteriores do fluxo, por exemplo {{$memory.paymentResponse}}.
Útil para rastreabilidade, validações posteriores ou decisões do fluxo.
Painel lateral do nó Conekta mostrando a aba Avançado com expiração do botão, moeda MXN, IVA, metadados e salvar resposta

Aba Avançado do nó Conekta


Como funciona a confirmação externa

Quando você seleciona Pagamento Confirmação Externa em Experiência de pagamento, o nó ativa internamente um agente conversacional que guia o pagador antes de gerar a cobrança.
1

O agente solicita os dados do pagador

Se o fluxo não enviar Nome do titular, Sobrenome do titular ou E-mail, o agente os pede diretamente na conversa, junto com o tipo de pagamento: aprovação no app BBVA Wallet (o agente a mostra como “redirecionamento externo ao BBVA”) ou código único SPEI.O pagador pode responder todos os dados juntos, por partes, ou até em uma nota de voz.
Conversa de WhatsApp onde o agente do Conekta solicita nome, sobrenome, e-mail e tipo de pagamento (redirecionamento BBVA ou código SPEI)

O agente solicita os dados faltantes para gerar o pagamento com Conekta

2

O agente confirma os dados antes de continuar

O agente mostra um resumo com os dados registrados e pede para responder Confirmar para continuar, ou indicar qual dado corrigir.
Conversa de WhatsApp com o resumo de dados do pagador e a instrução de responder Confirmar para continuar

Resumo de confirmação antes de gerar o pagamento

3

O pagador conclui o pagamento fora do WhatsApp

Conforme o tipo de pagamento escolhido:
  • Aprovação no BBVA Wallet: o pagador aprova o pagamento no app BBVA Wallet.
  • Código único SPEI: o agente entrega um código para colar na plataforma bancária do pagador e concluir a transferência.

Confirmação externa com Conekta: aprovação no BBVA Wallet

4

O Brain Studio continua o fluxo conforme o resultado

O Conekta notifica o status do pagamento via webhook e o nó continua pela saída correspondente (Pagamento bem-sucedido, Pagamento pendente, Pagamento falhou ou Erro), igual à experiência WebView.
Com Pagamento Confirmação Externa, o pagamento é concluído fora do WhatsApp (no app BBVA Wallet ou na plataforma bancária do pagador). O nó não abre WebView nem captura cartão dentro do chat.

Testar pagamentos em ambiente de teste

Se o Conekta estiver conectado com credenciais de teste, você pode testar o checkout com os dados de teste publicados pelo Conekta.
Em ambiente de teste, o pagamento é fictício e não move dinheiro real.
1

Confirmar credenciais de teste

Verifique se o Conekta está instalado com credenciais do ambiente de teste.
2

Configurar o nó em ambiente de teste

Na aba Avançado, verifique se o ambiente corresponde a desenvolvimento/teste e confirme a Experiência de pagamento que deseja testar (Pagamento WebView ou Pagamento Confirmação Externa).
3

Testar a partir do WhatsApp

Dispare o fluxo a partir do WhatsApp.
  • Com Pagamento WebView, abra o checkout do Conekta e selecione um método de pagamento de teste.
  • Com Pagamento Confirmação Externa, preencha os dados que o agente solicitar e siga o fluxo de aprovação no BBVA Wallet ou código SPEI.
4

Validar a saída do fluxo

Verifique por qual saída o fluxo continua:
  • Pagamento bem-sucedido
  • Pagamento pendente
  • Pagamento falhou
  • Erro

Passar para produção

Se você instalou o Conekta com credenciais de desenvolvimento/teste, pode iniciar a passagem para produção na aba Avançado do nó Conekta no Canvas ou na página do Conekta no Marketplace. Em ambos os casos abre-se o mesmo modal para inserir credenciais produtivas e confirmar a configuração correspondente. Antes de operar com pagamentos reais:
  • Certifique-se de ter credenciais de produção completas: chave pública e chave privada.
  • Use o fluxo Passar para produção descrito em Conectar no Brain Studio.
  • Substitua no nó qualquer dado de teste por dados reais do fluxo.
  • Execute um teste real de baixo valor antes de escalar.

Considerações importantes

Se instalou o Conekta com credenciais de teste, teste com dados de teste. Se instalou com credenciais de produção, use dados reais.
Em cenários pendentes ou falhos, informe com clareza antes de iniciar outra tentativa de cobrança. Mantenha novas tentativas controladas.
Com Pagamento Confirmação Externa, o pagamento não ocorre dentro do WhatsApp. Seu fluxo deve tratar Pagamento pendente e as saídas finais sem assumir confirmação imediata, assim como com outros provedores de confirmação externa.
Cartões e métodos de teste aplicam-se apenas em ambiente de teste. Em produção o usuário deve usar dados reais.

Próximo passo

Cobertura e preços

Revise disponibilidade, moeda, métodos de pagamento e considerações comerciais do Conekta.