Criar configuração

Para configurar a integração com a solução Split de pagamentos, você deverá criar sua aplicação, solicitar permissões aos seus usuários e obter as credenciais. Continue lendo para criar a configuração necessária.

Crie sua aplicação para integrar com a solução Split de pagamentos seguindo os passos abaixo.

1. Acesse Suas integrações. Uma vez lá, clique no botão Criar aplicação, localizado no canto superior direito.
2. Insira um nome para identificar sua aplicação (você tem um limite de 50 caracteres).
3. Escolha a solução de Pagamentos online.
4. Ao escolher o produto a ser integrado, você pode optar por "Checkout Pro" ou "Checkout API".
5. Escolha o modelo de integração Marketplace.
6. Após preencher as informações solicitadas, clique em Criar aplicação e pronto!

Nesta etapa, é necessário configurar o Redirect URL para que os vendedores possam autorizar o marketplace a realizar vendas.

Após criar a aplicação, é necessário ir para a tela de edição para preencher o campo de Redirect URL (nas solicitações de OAuth, é mostrado como redirect_uri), o qual deve conter a URL do site do marketplace para onde o token do vendedor será enviado ao concluir o processo de vinculação.

Para solicitar permissão aos seus usuários para gerenciar vendas em seu nome, é necessário implementar o fluxo de autorização usando o OAuth. Siga os passos abaixo:

1. Redirecione seus usuários para a seguinte URL para autorizar o gerenciamento de vendas:

https://auth.mercadopago.com.br/authorization?client_id=<APP_ID>&response_type=code&platform_id=mp&redirect_uri=<REDIRECT_URI>

2. Assim que os usuários autorizarem o gerenciamento de vendas, você receberá um código de autorização na URL que especificou no passo anterior. Este código estará no parâmetro code da seguinte forma:

http://<REDIRECT_URI>?code=AUTHORIZATION_CODE

Utilize o código de autorização obtido na etapa anterior para adquirir as credenciais do usuário por meio da API de OAuth, permitindo a gestão de suas vendas.

curl -X POST \
     -H 'accept: application/json' \
     -H 'content-type: application/x-www-form-urlencoded' \
     'https://api.mercadopago.com/oauth/token' \
     -d 'client_id=<CLIENT_ID>' \
     -d 'client_secret=<CLIENT_SECRET>' \
     -d 'grant_type=authorization_code' \
     -d 'code=<AUTHORIZATION_CODE>' \
     -d 'redirect_uri=<REDIRECT_URI>' \
     -d 'state=<RANDOM_ID>'

{
    "access_token": "SELLER_PAYER_TOKEN",
    "public_key": "PUBLIC_KEY",
    "refresh_token": "TG-XXXXXXXXX-XXXXX",
    "live_mode": true,
    "user_id": "COLLECTOR_ID DE PAGO",
    "token_type": "bearer",
    "expires_in": 15552000,
    "scope": "offline_access payments write"
}

A resposta inclui:

• access_token e public_key do vendedor vinculado.
• refresh_token, que deve ser utilizado para renovar periodicamente as vinculações.
• user_id, igual ao collector_id utilizado para capturar pagamentos.