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

# Obtendo credenciais

> Guia passo a passo para gerar seu Access Token do Mercado Pago (Teste e Produção) e conectá-lo ao Brain Studio.

## Quando você precisa disso?

Você precisará disso quando tentar **Conectar** o Mercado Pago no Marketplace e o Brain Studio solicitar um **Access Token**.

***

Para conectar o **Mercado Pago** ao **Brain Studio** você precisa de um **Access Token**, associado a uma aplicação (App) criada na conta do lojista.

Este guia explica como obter **credenciais de teste** e **credenciais de produção**, e quando usar cada uma.

<Check>
  Ao final deste guia você terá um Access Token (Teste ou Produção) pronto para instalar o Mercado Pago no Brain Studio.
</Check>

## Antes de começar

<Info>
  Você precisa de uma **conta ativa** no Mercado Pago, **acesso ao painel do lojista** e **permissões para criar aplicações**. Não é necessário conhecimento técnico avançado.
</Info>

## Não tem uma conta no Mercado Pago?

<Accordion title="Selecione seu país para criar uma conta">
  <CardGroup cols={2}>
    <Card title="Peru" href="https://www.mercadopago.com.pe" icon={<span style={{ fontSize: '1.5rem', lineHeight: 1 }}>🇵🇪</span>} horizontal>
      mercadopago.com.pe
    </Card>

    <Card title="Colômbia" href="https://www.mercadopago.com.co" icon={<span style={{ fontSize: '1.5rem', lineHeight: 1 }}>🇨🇴</span>} horizontal>
      mercadopago.com.co
    </Card>

    <Card title="México" href="https://www.mercadopago.com.mx" icon={<span style={{ fontSize: '1.5rem', lineHeight: 1 }}>🇲🇽</span>} horizontal>
      mercadopago.com.mx
    </Card>

    <Card title="Chile" href="https://www.mercadopago.cl" icon={<span style={{ fontSize: '1.5rem', lineHeight: 1 }}>🇨🇱</span>} horizontal>
      mercadopago.cl
    </Card>

    <Card title="Brasil" href="https://www.mercadopago.com.br" icon={<span style={{ fontSize: '1.5rem', lineHeight: 1 }}>🇧🇷</span>} horizontal>
      mercadopago.com.br
    </Card>

    <Card title="Argentina" href="https://www.mercadopago.com.ar" icon={<span style={{ fontSize: '1.5rem', lineHeight: 1 }}>🇦🇷</span>} horizontal>
      mercadopago.com.ar
    </Card>

    <Card title="Uruguai" href="https://www.mercadopago.com.uy" icon={<span style={{ fontSize: '1.5rem', lineHeight: 1 }}>🇺🇾</span>} horizontal>
      mercadopago.com.uy
    </Card>
  </CardGroup>
</Accordion>

## Passos para obter credenciais

<Steps>
  <Step title="Entrar no painel do Mercado Pago">
    **Faça login** na conta de lojista do Mercado Pago.
  </Step>

  <Step title="Acessar suas integrações">
    No menu da sua conta, **navegue** até:

    **Seu negócio → Configurações → Suas integrações**

    É aqui que **aplicações** e **credenciais** da conta são gerenciadas.

    <Frame caption="Navegando até Suas integrações no painel do Mercado Pago">
      <img src="https://mintcdn.com/jelouai/y5L6vahGrhMqbaUQ/assets/images/integraciones/pagos/mercado-pago-tus-integraciones.png?fit=max&auto=format&n=y5L6vahGrhMqbaUQ&q=85&s=3a33f5770262056236f95fe9f540d85e" alt="Navegando até Suas integrações no painel do Mercado Pago" width="2048" height="955" data-path="assets/images/integraciones/pagos/mercado-pago-tus-integraciones.png" />
    </Frame>
  </Step>

  <Step title="Criar uma aplicação">
    Para gerar credenciais, você deve primeiro **criar uma aplicação**:

    1. Clique em **Criar aplicação**
    2. **Insira um nome** para o app (o nome é livre)
    3. **Conclua** a criação

    <Info>
      A aplicação **não processa pagamentos** por conta própria. Ela é usada exclusivamente para **gerar credenciais**.
    </Info>

    <Frame caption="Criando uma aplicação no Mercado Pago">
      <video controls className="w-full aspect-video rounded-xl" src="https://mintcdn.com/jelouai/c4aHWk5mWPCIlk-Z/assets/videos/integraciones/pagos/mercado-pago/mercado-pago-creacion-app.mp4?fit=max&auto=format&n=c4aHWk5mWPCIlk-Z&q=85&s=dd60f74097ac50cae372d2111f8ef6ec" data-path="assets/videos/integraciones/pagos/mercado-pago/mercado-pago-creacion-app.mp4" />
    </Frame>
  </Step>

  <Step title="Acessar as credenciais da App">
    Dentro da aplicação criada:

    1. **Acesse** a seção **Credenciais**
    2. Você verá **dois tipos** de credenciais:
       * **Credenciais de teste**
       * **Credenciais de produção**

    <Check>
      Se você consegue ver o Access Token na seção Credenciais, esta etapa foi concluída com sucesso.
    </Check>

    <Frame caption="Vídeo: Acessando credenciais">
      <video controls className="w-full aspect-video rounded-xl" src="https://mintcdn.com/jelouai/c4aHWk5mWPCIlk-Z/assets/videos/integraciones/pagos/mercado-pago/mercado-pago-credenciales.mp4?fit=max&auto=format&n=c4aHWk5mWPCIlk-Z&q=85&s=97a4634132bb4b68b65d22850c96134a" data-path="assets/videos/integraciones/pagos/mercado-pago/mercado-pago-credenciales.mp4" />
    </Frame>
  </Step>

  <Step title="Copiar o Access Token">
    <Tabs>
      <Tab title="Credenciais de teste">
        * Geradas **automaticamente** quando a aplicação é criada.
        * Incluem um **Access Token de teste**.
        * Permitem **testar** a integração sem processar pagamentos reais.
        * Ideais para **desenvolvimento** e **validações internas**.

        Copie o **Access Token de teste** para usar em ambientes de teste.
      </Tab>

      <Tab title="Credenciais de produção">
        * Habilitadas quando o app é **ativado para produção**.
        * Incluem um **Access Token de produção**.
        * **Necessárias** para aceitar pagamentos reais.

        Em alguns países, o Mercado Pago pode solicitar **informações adicionais** antes de habilitar a produção.

        Copie o **Access Token de produção** para cobranças reais.
      </Tab>
    </Tabs>

    <Warning>
      Para **ambientes de produção** no Jelou, você deve usar **credenciais de produção**. Tokens de teste **não processam pagamentos reais**.
    </Warning>
  </Step>

  <Step title="Usar o Access Token no Brain Studio">
    Durante a **instalação** pelo **Marketplace** do Brain Studio você será solicitado a inserir o **Access Token**.

    Após configurado:

    * Os pagamentos são processados **diretamente** na conta do lojista.
    * O Jelou **não retém fundos**.
    * O resultado do pagamento retorna ao **fluxo conversacional**.
  </Step>
</Steps>

## Solução de problemas

<AccordionGroup>
  <Accordion title="Não consigo ativar as credenciais de produção">
    O Mercado Pago pode exigir:

    * Completar dados fiscais do negócio
    * Definir setor ou categoria
    * Adicionar um site válido

    Verifique a seção **Dados do negócio** na sua conta do Mercado Pago e complete as informações pendentes.
  </Accordion>

  <Accordion title="Não consigo ver a seção Credenciais">
    Verifique que:

    * A aplicação foi criada corretamente
    * Você está dentro do App e não na visualização geral
    * Você tem permissões suficientes na conta

    Se o problema persistir, revise as permissões de usuário no Mercado Pago.
  </Accordion>
</AccordionGroup>

## Boas práticas

<AccordionGroup>
  <Accordion title="Segurança do Access Token">
    * **Não compartilhe** seu Access Token.
    * Se suspeitar de **exposição** do token, **rotacione-o** pelo painel do Mercado Pago.
  </Accordion>

  <Accordion title="Uso por ambiente">
    * Use **tokens de teste** somente em ambientes de teste.
    * **Troque** para credenciais de produção antes de entrar em produção.
  </Accordion>
</AccordionGroup>
