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

# Mercado Pago Split

> Como criar uma aplicação no Mercado Pago Developers e conectar o split de pagamentos na Velan.

O **Mercado Pago Split** permite dividir automaticamente os valores dos pagamentos entre vendedores e o marketplace. Para ativá-lo, você precisa criar uma aplicação no portal de desenvolvedores do Mercado Pago e conectar as credenciais na Velan.

<Warning>
  O Mercado Pago Split atualmente suporta apenas divisão **1:1** — um único parceiro por transação. Não é possível dividir o pagamento entre múltiplos vendedores simultaneamente.
</Warning>

<Note>
  Você precisará de uma conta no [Mercado Pago](https://www.mercadopago.com.br/developers/panel/app) para realizar este processo.
</Note>

***

## Parte 1 — Criando a aplicação no Mercado Pago

<Steps>
  <Step title="Acesse o portal de desenvolvedores e crie uma aplicação">
    Acesse o [painel de aplicações do Mercado Pago](https://www.mercadopago.com.br/developers/panel/app), vá em **Integrações → Suas aplicações** e clique em **Criar aplicação**.

    <Frame>
      <img src="https://mintcdn.com/velanapp/K_mdw3o5XduvZc5v/images/create-app-mp/create_app_01.png?fit=max&auto=format&n=K_mdw3o5XduvZc5v&q=85&s=3bc42fe5781816ea3cf7ec698910e8f4" alt="Tela de Integrações com botão Criar aplicação" width="2343" height="885" data-path="images/create-app-mp/create_app_01.png" />
    </Frame>
  </Step>

  <Step title="Defina o nome da aplicação">
    No formulário (passo 1 de 4), insira um nome para identificar sua aplicação — por exemplo: `Minha empresa split`. Clique em **Continuar**.

    <Frame>
      <img src="https://mintcdn.com/velanapp/K_mdw3o5XduvZc5v/images/create-app-mp/create_app_02.png?fit=max&auto=format&n=K_mdw3o5XduvZc5v&q=85&s=7d2db3f569482a37271a2365a554e561" alt="Formulário com nome da aplicação preenchido" width="2555" height="930" data-path="images/create-app-mp/create_app_02.png" />
    </Frame>
  </Step>

  <Step title="Escolha o tipo de pagamento e a origem da loja">
    No passo 2 de 4:

    * Em **Tipo de pagamento**, selecione **Pagamentos online**.
    * Em **Como você criou a loja?**, selecione **Através de uma plataforma**.

    Clique em **Continuar**.

    <Frame>
      <img src="https://mintcdn.com/velanapp/K_mdw3o5XduvZc5v/images/create-app-mp/create_app_03.png?fit=max&auto=format&n=K_mdw3o5XduvZc5v&q=85&s=0f1e36084c6573be818d59279a9c8f9f" alt="Seleção de tipo de pagamento e origem da loja" width="2364" height="901" data-path="images/create-app-mp/create_app_03.png" />
    </Frame>
  </Step>

  <Step title="Informe a plataforma Velan">
    Na lista de plataformas, a Velan não aparece como opção padrão. Role até o final da lista e no campo **Outra plataforma** digite `Velan`. Clique em **Continuar**.

    <Frame>
      <img src="https://mintcdn.com/velanapp/K_mdw3o5XduvZc5v/images/create-app-mp/create_app_04.png?fit=max&auto=format&n=K_mdw3o5XduvZc5v&q=85&s=d7a6a8b9778584051d42e94012d1c4e6" alt="Campo Outra plataforma com Velan preenchido" width="2557" height="933" data-path="images/create-app-mp/create_app_04.png" />
    </Frame>
  </Step>

  <Step title="Confirme e crie a aplicação">
    No passo 4 de 4, revise as opções selecionadas:

    | Campo                    | Valor                     |
    | ------------------------ | ------------------------- |
    | Nome da aplicação        | Minha empresa split       |
    | Tipo de pagamento        | Pagamentos online         |
    | Como criou a loja        | Através de uma plataforma |
    | Solução de pagamento     | Checkout Pro              |
    | Plataforma de integração | Velan                     |

    Aceite os termos, complete o **reCAPTCHA** e clique em **Confirmar**.

    <Frame>
      <img src="https://mintcdn.com/velanapp/K_mdw3o5XduvZc5v/images/create-app-mp/create_app_05.png?fit=max&auto=format&n=K_mdw3o5XduvZc5v&q=85&s=bce1f2e2d40e7dc67002fe801c0aaca2" alt="Tela de confirmação das opções antes de criar" width="2006" height="929" data-path="images/create-app-mp/create_app_05.png" />
    </Frame>
  </Step>
</Steps>

***

## Parte 2 — Configurando a aplicação

<Steps>
  <Step title="Acesse as configurações da aplicação">
    Após criar a aplicação, você será redirecionado para a página de detalhes. No menu lateral esquerdo, clique em **Configurações da aplicação**.

    <Frame>
      <img src="https://mintcdn.com/velanapp/K_mdw3o5XduvZc5v/images/create-app-mp/create_app_06.png?fit=max&auto=format&n=K_mdw3o5XduvZc5v&q=85&s=32f249d97d8e3ff6766e6b427dc53ec0" alt="Detalhes da aplicação com menu lateral destacando Configurações da aplicação" width="2375" height="928" data-path="images/create-app-mp/create_app_06.png" />
    </Frame>
  </Step>

  <Step title="Configure a URL de redirecionamento OAuth e as permissões">
    Na seção **Configuração avançada**, adicione a seguinte URL no campo de redirecionamento OAuth:

    ```
    https://api.velan.app/v1/mercadopago/partner/callback
    ```

    Certifique-se de que as seguintes **Permissões da aplicação** estão marcadas:

    * `read`
    * `offline_access`
    * `write`
    * `Application & User API's`

    Salve as configurações.

    <Frame>
      <img src="https://mintcdn.com/velanapp/K_mdw3o5XduvZc5v/images/create-app-mp/create_app_07.png?fit=max&auto=format&n=K_mdw3o5XduvZc5v&q=85&s=73bfd5b6896815519dcb7c486c388077" alt="Configuração avançada com URL de callback e permissões marcadas" width="2562" height="930" data-path="images/create-app-mp/create_app_07.png" />
    </Frame>
  </Step>
</Steps>

***

## Parte 3 — Ativando as credenciais de produção

<Steps>
  <Step title="Preencha os dados para ativar as credenciais">
    No menu lateral, em **PRODUÇÃO**, clique em **Credenciais de produção**. Preencha:

    * **Setor**: escolha a categoria que melhor descreve seu negócio.
    * **Site (opcional)**: insira a URL do seu site (ex: `https://velan.app/`).

    Aceite os termos, complete o **reCAPTCHA** e clique em **Ativar credenciais de produção**.

    <Frame>
      <img src="https://mintcdn.com/velanapp/K_mdw3o5XduvZc5v/images/create-app-mp/create_app_08.png?fit=max&auto=format&n=K_mdw3o5XduvZc5v&q=85&s=bad6f3464b52f3b04840df2aa2874c7a" alt="Formulário de ativação de credenciais de produção" width="2384" height="925" data-path="images/create-app-mp/create_app_08.png" />
    </Frame>
  </Step>

  <Step title="Copie as credenciais geradas">
    Com as credenciais ativadas, copie os quatro valores que serão usados na Velan:

    | Credencial        | Descrição                    |
    | ----------------- | ---------------------------- |
    | **Public Key**    | Chave pública (APP\_USR-...) |
    | **Access Token**  | Token de acesso para as APIs |
    | **Client ID**     | Identificador da aplicação   |
    | **Client Secret** | Chave secreta da aplicação   |

    <Frame>
      <img src="https://mintcdn.com/velanapp/K_mdw3o5XduvZc5v/images/create-app-mp/create_app_09.png?fit=max&auto=format&n=K_mdw3o5XduvZc5v&q=85&s=23210f675e1593f62de561ba73e9e964" alt="Tela de credenciais de produção com Public Key, Access Token, Client ID e Client Secret" width="2377" height="930" data-path="images/create-app-mp/create_app_09.png" />
    </Frame>
  </Step>
</Steps>

***

## Parte 4 — Conectando na Velan

<Steps>
  <Step title="Localize o card Mercado Pago Split nas integrações">
    No painel da Velan, acesse **Integrações** no menu lateral. Localize o card **Mercado Pago Split** e clique em **INTEGRATE**.

    <Frame>
      <img src="https://mintcdn.com/velanapp/K_mdw3o5XduvZc5v/images/create-app-mp/create_app_11.png?fit=max&auto=format&n=K_mdw3o5XduvZc5v&q=85&s=736d624ac55d2633647673156647c401" alt="Card Mercado Pago Split com botão INTEGRATE" width="727" height="358" data-path="images/create-app-mp/create_app_11.png" />
    </Frame>
  </Step>

  <Step title="Insira as credenciais e conecte">
    No modal **Conectar Mercado Pago Split**, preencha os campos com as credenciais copiadas do portal de desenvolvedores do Mercado Pago:

    * **Public Key**
    * **Access Token**
    * **Client ID**
    * **Client Secret**

    Clique em **Conectar**.

    <Frame>
      <img src="https://mintcdn.com/velanapp/K_mdw3o5XduvZc5v/images/create-app-mp/create_app_12.png?fit=max&auto=format&n=K_mdw3o5XduvZc5v&q=85&s=9b75a1695c92c69e0a5732423cefb862" alt="Modal de conexão com campos de credenciais preenchidos" width="2562" height="926" data-path="images/create-app-mp/create_app_12.png" />
    </Frame>
  </Step>

  <Step title="Integração ativa">
    Com a integração ativada, o painel exibirá as informações da conexão:

    * **App ID** — identificador da aplicação no Mercado Pago
    * **Public Key** — chave pública configurada
    * **Collector ID** — ID do coletor associado à sua conta
    * **Desde** — data de ativação da integração

    Na seção **Parceiros no split**, clique em **Gerenciar parceiros** para configurar quais vendedores participam da divisão de pagamentos.

    <Frame>
      <img src="https://mintcdn.com/velanapp/K_mdw3o5XduvZc5v/images/create-app-mp/create_app_13.png?fit=max&auto=format&n=K_mdw3o5XduvZc5v&q=85&s=e6ee0093d1c9003524d12302167ee593" alt="Tela de integração ativa com informações da conexão e seção de parceiros" width="2559" height="932" data-path="images/create-app-mp/create_app_13.png" />
    </Frame>
  </Step>
</Steps>