Skip to main content
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 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.
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

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
padrão:"WebView"
Indica que o checkout do Conekta abre como WebView incorporado dentro da experiência conversacional.
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


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.
3

Testar a partir do WhatsApp

Dispare o fluxo a partir do WhatsApp, abra o checkout WebView do Conekta e selecione um método de pagamento de teste.
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.
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.