> ## 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 PayPal no Brain Studio, configure suas credenciais e use o nó de pagamento nos seus fluxos.

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

***

## Antes de começar

Certifique-se de ter:

* Uma **conta PayPal habilitada para uso comercial e de API**
* O **Client Id**
* O **Client Secret**
* O **IVA aplicado** que a integração utilizará
* A **Moeda** em que será feita a cobrança
* As credenciais corretas para o seu ambiente: **desenvolvimento/teste** ou **produção**

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

<Warning>
  Para que o checkout seja aberto dentro do WhatsApp (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 PayPal a partir de diferentes pontos do Brain Studio. Todos os caminhos usam a mesma configuração do provedor.

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

    Exemplos:

    * "Adicione pagamentos com PayPal a este fluxo"
    * "Preciso de um checkout com PayPal para este caso"

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

  <Tab title="Marketplace">
    Abra o **Marketplace**, busque por **PayPal** em **Pagamentos & Processamento** ou use o buscador.

    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ê verá o **PayPal** 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.

    <Frame caption="PayPal disponível para instalar a partir do nó Pagamentos no Canvas">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/paypal-pagos-instalar.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=3ca0582f739663446676165d65278639" alt="Nó Pagamentos no Canvas mostrando o PayPal como provedor disponível com a opção Instalar" style={{ maxHeight: '355px', width: 'auto', margin: '0 auto' }} width="422" height="614" data-path="assets/images/integraciones/pagos/paypal-pagos-instalar.png" />
    </Frame>
  </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 que você escolha um provedor de pagamento e conecte o PayPal como parte do fluxo de configuração.
  </Tab>
</Tabs>

<Note>
  Todos os caminhos de instalação usam a mesma configuração do provedor. O que muda é o ponto de onde você inicia o fluxo.
</Note>

***

## Fluxo comum de instalação

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

<Steps>
  <Step title="Escolher credenciais de teste ou produção">
    O Brain Studio pedirá que você selecione se conectará o PayPal com **credenciais de teste** ou com **credenciais de produção**.

    No PayPal, essas credenciais correspondem aos ambientes **Sandbox** ou **Live**.

    <Frame caption="Seleção do ambiente para conectar o PayPal">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/paypal-conectar-seleccion-ambiente.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=ad0f15f89b7d9f98ca5c9045cd4995bb" alt="Modal do Brain Studio para escolher entre credenciais de teste ou credenciais de produção ao conectar o PayPal" width="1024" height="383" data-path="assets/images/integraciones/pagos/paypal-conectar-seleccion-ambiente.png" />
    </Frame>
  </Step>

  <Step title="Preencher as credenciais">
    Preencha o modal com:

    * **Client Id**
    * **Client Secret**

    <Frame caption="Credenciais necessárias para conectar o PayPal">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/paypal-modal-credenciales.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=0369349f1ecb57f09347f58151a44ee3" alt="Modal do Brain Studio para inserir Client Id e Client Secret do PayPal" width="1024" height="535" data-path="assets/images/integraciones/pagos/paypal-modal-credenciales.png" />
    </Frame>
  </Step>

  <Step title="Configurar IVA aplicado e Moeda">
    Defina o **IVA aplicado** que a integração utilizará e selecione a **Moeda** de operação.
  </Step>

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

  <Step title="Usar o PayPal pelo nó Pagamentos no Canvas">
    Depois de instalar, você poderá usar o PayPal a partir do nó **Pagamentos** no **Canvas**, independentemente de ter iniciado a instalação pelo Jelou Agent, Marketplace, nó Pagamentos ou template.
  </Step>
</Steps>

***

## Credenciais de desenvolvimento vs produção

O PayPal separa as credenciais por ambiente:

* **Sandbox:** credenciais para testes sem processar pagamentos reais.
* **Live:** credenciais para processar pagamentos reais.

O PayPal usa **Client Id** e **Client Secret** diferentes conforme o ambiente. O **IVA aplicado** e a **Moeda** são definidos durante a conexão.

Para obter as credenciais do PayPal, consulte [Obtenção de credenciais](/pt/guias/integracoes/pagamentos/provedores/paypal/obter-credenciais).

<Warning>
  As credenciais de desenvolvimento não processam pagamentos reais. Antes de operar em produção, você deve conectar o PayPal usando credenciais produtivas.
</Warning>

<Tip>
  Se conectar o PayPal com credenciais de desenvolvimento/teste, você precisará de uma conta Sandbox Personal do PayPal para concluir pagamentos fictícios durante os testes. Consulte [Uso e configuração](/pt/guias/integracoes/pagamentos/provedores/paypal/uso-e-configuracao).
</Tip>

***

## Passar para produção

Se você instalou o PayPal 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:

    * A **barra lateral avançada** do nó PayPal no **Canvas**
    * A página de **PayPal** no **Marketplace**

    Em ambos os casos, é aberto o mesmo modal para passar a integração para produção.
  </Step>

  <Step title="Preencher Client Id e Client Secret produtivos">
    Insira o **Client Id** e o **Client Secret** produtivos.

    <Frame caption="Credenciais produtivas para passar o PayPal para produção">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/paypal-pasar-a-produccion-credenciales.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=b741d27bc9a6022a124e28e4c339b836" alt="Modal do Brain Studio para inserir Client Id e Client Secret produtivos do PayPal" width="1024" height="546" data-path="assets/images/integraciones/pagos/paypal-pasar-a-produccion-credenciales.png" />
    </Frame>
  </Step>

  <Step title="Confirmar IVA aplicado e Moeda">
    Revise e confirme o **IVA aplicado** e a **Moeda** que a integração usará em produção.
  </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 a seção **Passar para produção**.
* Para **rotacionar credenciais** ou **substituir a configuração**, desconecte o PayPal e instale novamente seguindo o **fluxo comum de instalação** desta página.

***

## Próximo passo

Uma vez conectada a integração, continue com:

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