> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar no Brain Studio

> Instale o Conekta no Brain Studio, configure suas credenciais e use o nó de pagamento nos seus fluxos.

Conecte o Conekta para habilitar o provedor no seu workspace e deixar disponível o nó de pagamento no Brain Studio com experiência de **WebView incorporado**.

***

## Antes de começar

Certifique-se de ter:

* Uma **conta ativa do Conekta**
* A **chave pública** do Conekta
* A **chave privada** do Conekta
* O **percentual de IVA** que será aplicado na operação
* O **webhook** configurado no Conekta para o ambiente que você vai conectar
* Credenciais corretas conforme o ambiente: **teste** ou **produção**

<Tip>
  Para obter ou revisar credenciais e webhooks, siga [Obtenção de credenciais](/pt/guias/integracoes/pagamentos/provedores/conekta/obter-credenciais).
</Tip>

<Warning>
  Para que o checkout abra dentro do WhatsApp como WebView incorporado, a conta precisa ser **WhatsApp Business verificada**.

  Se não estiver verificada, o checkout será aberto no navegador externo do dispositivo.
</Warning>

***

## Formas de iniciar a instalação

Você pode iniciar a instalação do Conekta a partir de diferentes pontos do Brain Studio. Todas as rotas usam a mesma configuração do provedor.

<Tabs>
  <Tab title="Jelou Agent">
    Peça ao Jelou Agent para adicionar pagamentos com Conekta enquanto constrói ou ajusta um fluxo.

    Exemplos:

    * "Adicione pagamentos com Conekta a este fluxo"
    * "Preciso cobrar com Conekta neste caso"
    * "Quero processar pagamentos com Conekta"

    O Jelou Agent detecta o Conekta como provedor disponível no Marketplace e inicia o fluxo assistido de instalação.
  </Tab>

  <Tab title="Marketplace">
    Abra o **Marketplace**, busque **Conekta** em **Pagamentos & Processamento** ou use a barra de pesquisa.

    Em seguida, pressione **Conectar** ou **Instalar** para iniciar o fluxo de instalação.
  </Tab>

  <Tab title="Nó Pagamentos">
    Na barra de ferramentas do **Canvas**, abra o nó **Pagamentos**.

    Dentro do nó **Pagamentos**, você pode ver o **Conekta** como provedor disponível. Se ainda não estiver conectado, pressione **Instalar** para iniciar o mesmo fluxo de conexão usado pelo Marketplace, Jelou Agent e templates.
  </Tab>

  <Tab title="Templates">
    Alguns templates do Brain Studio podem incluir configuração de pagamentos.

    Durante a criação do template, o Brain Studio pode pedir para escolher um provedor de pagamento e conectar o Conekta como parte do fluxo de configuração.
  </Tab>
</Tabs>

<Note>
  Todas as rotas de instalação usam a mesma configuração do provedor. O que muda é de onde você inicia o fluxo.
</Note>

***

## Fluxo comum de instalação

Independentemente do ponto de entrada, o processo compartilhado é o seguinte.

<Steps>
  <Step title="Escolher credenciais de teste ou produção">
    O Brain Studio pedirá para selecionar se conectará o Conekta com **credenciais de teste** ou com **credenciais de produção**.

    <Frame caption="Passo 1 de 3: seleção do ambiente para conectar o Conekta">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/conekta-conectar-seleccion-ambiente.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=3af13acf44e2efb0379ea88f65d4017b" alt="Modal do Brain Studio passo 1 de 3 para escolher credenciais de teste ou credenciais de produção ao conectar o Conekta" width="1024" height="477" data-path="assets/images/integraciones/pagos/conekta-conectar-seleccion-ambiente.png" />
    </Frame>
  </Step>

  <Step title="Completar chave pública e chave privada">
    Preencha o modal com:

    * **Chave pública**
    * **Chave privada**

    <Frame caption="Passo 2 de 3: credenciais necessárias para conectar o Conekta">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/conekta-conectar-credenciales.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=aa61c8acee434c8523199b2d52d74217" alt="Modal do Brain Studio passo 2 de 3 para inserir a chave pública e a chave privada do Conekta" width="1024" height="611" data-path="assets/images/integraciones/pagos/conekta-conectar-credenciales.png" />
    </Frame>
  </Step>

  <Step title="Configurar IVA e moeda de cobrança">
    Defina o **IVA aplicado** e confirme a **moeda de cobrança**.

    Para Conekta México, a moeda costuma ser **MXN — Peso mexicano**.

    <Frame caption="Passo 3 de 3: IVA aplicado e moeda de cobrança">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/conekta-conectar-iva.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=ee816f07339baa3c9f33e539b80f9003" alt="Modal do Brain Studio passo 3 de 3 para configurar o IVA aplicado e a moeda de cobrança MXN ao conectar o Conekta" width="1024" height="614" data-path="assets/images/integraciones/pagos/conekta-conectar-iva.png" />
    </Frame>
  </Step>

  <Step title="Confirmar conexão">
    Pressione **Conectar integração**. O Brain Studio salvará a configuração e deixará o **Conekta** disponível no seu workspace.
  </Step>

  <Step title="Usar o Conekta a partir do nó Pagamentos no Canvas">
    Após instalar, você poderá usar o Conekta a partir do nó **Pagamentos** no **Canvas**, tenha o fluxo começado pelo Jelou Agent, Marketplace, nó Pagamentos ou um template.
  </Step>
</Steps>

***

## Credenciais de teste vs produção

O Conekta separa as credenciais por ambiente:

* **Teste:** credenciais para testes sem dinheiro real.
* **Produção:** credenciais para processar pagamentos reais.

<Warning>
  As credenciais de teste não processam pagamentos reais. Antes de operar em produção, conecte o Conekta com credenciais produtivas ou use **Passar para produção**.
</Warning>

<Tip>
  Use sempre credenciais do mesmo ambiente. Não misture chaves de teste com chaves de produção.
</Tip>

***

## Passar para produção

Se você instalou o Conekta com credenciais de **desenvolvimento/teste**, pode usar o nó de pagamento para testes. Para operar com pagamentos reais:

<Steps>
  <Step title="Abrir Passar para produção">
    Você pode iniciar a mudança a partir de qualquer um destes pontos:

    <Tabs>
      <Tab title="Painel Avançado no Canvas">
        Abra o nó **Conekta** no **Canvas**, vá para a aba **Avançado** do painel lateral e selecione **Produção**.

        <Frame caption="Passar para produção a partir da aba Avançado do nó Conekta">
          <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/conekta-pasar-a-produccion-avanzado.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=e37f5dda76e3927684bc8426ce436895" alt="Painel lateral Avançado do nó Conekta no Canvas com opção para passar a integração para produção" width="1024" height="592" data-path="assets/images/integraciones/pagos/conekta-pasar-a-produccion-avanzado.png" />
        </Frame>
      </Tab>

      <Tab title="Marketplace">
        Abra a página do **Conekta** no **Marketplace** e pressione **Passar para produção**.

        <Frame caption="Passar para produção a partir da página do Conekta no Marketplace">
          <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/conekta-pasar-a-produccion-marketplace.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=e112790ed41ee263affab57f61837b74" alt="Página do Conekta no Marketplace com o botão Passar para produção" width="582" height="440" data-path="assets/images/integraciones/pagos/conekta-pasar-a-produccion-marketplace.png" />
        </Frame>
      </Tab>
    </Tabs>

    Em ambos os casos abre-se o mesmo modal para passar a integração para produção.
  </Step>

  <Step title="Completar credenciais produtivas">
    Insira as credenciais de produção:

    * **Chave pública**
    * **Chave privada**

    <Frame caption="Modal para passar o Conekta para produção">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/conekta-pasar-a-produccion-modal.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=517b7f44aedf3572a5fc696b8a43fc8e" alt="Modal do Brain Studio para passar o Conekta para produção inserindo chave pública e chave privada produtivas" width="1024" height="625" data-path="assets/images/integraciones/pagos/conekta-pasar-a-produccion-modal.png" />
    </Frame>

    <Warning>
      Em produção, cada transação tem um custo de **US\$ 0,10** por pagamento, descontado do seu saldo no Brain Studio, além das tarifas do Conekta.
    </Warning>
  </Step>

  <Step title="Confirmar a mudança">
    Confirme a ação. A partir desse momento, a integração opera com credenciais de produção.
  </Step>
</Steps>

***

## Alterar credenciais

* Para passar de **desenvolvimento/teste** para **produção** com a mesma instalação, use **Passar para produção**.
* Para **rotacionar credenciais** ou **substituir a configuração**, desconecte o Conekta e reinstale seguindo o **fluxo comum de instalação** desta página.

***

## Próximo passo

Depois de conectada a integração, continue com:

<Card title="Uso e configuração" href="/pt/guias/integracoes/pagamentos/provedores/conekta/uso-e-configuracao" icon="gear">
  Configure o nó de pagamento e continue o fluxo conforme o resultado do pagamento em WebView.
</Card>
