Pré-requisitos
Considere os pontos a seguir antes de começar:
- Acesse uma conta
- Crie uma aplicação
- Acesse as credenciais de teste
- Obtenha o seu Access Token (OAuth)
- Identifique a sua integração (Sponsor ID)
1. Acesse uma conta
Para começar a integração, você precisa ter uma conta no Mercado Pago ou Mercado Livre.
Você pode acessar uma conta existente ou Criar uma nova conta.
2. Crie uma aplicação
As aplicações são entidades registradas dentro do Mercado Pago que atuam como um identificador único para gerenciar a autenticação e a autorização de suas integrações. Ou seja, são o vínculo entre seu desenvolvimento e o Mercado Pago e constituem como a primeira etapa para realizar a integração.
Com elas, é possível acessar as credenciaisChaves de acesso únicas que usamos para identificar uma integração na sua conta, estando vinculadas à sua aplicação. Para mais informações, acesse o link abaixo.Credenciais necessárias para interagir com nossas APIs ou serviços específicos, além de gerenciar e organizar sua integração. Por isso, será necessário criar uma aplicação para cada solução do Mercado Pago integrada.
Para criar uma aplicação, siga os passos abaixo.
- No canto superior direito de Mercado Pago Developers, clique em Entrar e faça login em sua conta do Mercado Pago.
- Com a sessão iniciada, no canto superior direito do Mercado Pago Developers, clique em Criar aplicação se a sua conta ainda não tiver nenhuma aplicação criada, ou acesse "Suas integrações" e selecione Ver todas. Nela, clique em Criar aplicação.
- Uma vez dentro de Suas integrações, clique no botão Criar aplicação.
- Insira um nome para identificar sua aplicação. O limite é de até 50 caracteres alfanuméricos.
3. Acesse as credenciais de teste
Após criar sua aplicação, também serão criadas automaticamente as credenciais de testeChaves de acesso únicas com as quais identificamos uma integração em sua conta, vinculadas à sua aplicação. Para mais informações, acesse o link abaixo.Credenciais. Utilize as credenciais de teste para realizar todas as configurações e validações necessárias em um ambiente seguro de testes.
Ao acessar as credenciais de teste, serão exibidos os seguintes pares de credenciais: Public KeyChave pública que é utilizada no frontend para acessar informações e criptografar dados. Você pode acessá-la através de Suas integrações > Detalhes da aplicação > Testes > Credenciais de teste. e o Access TokenChave privada da aplicação criada no Mercado Pago, que é utilizada no backend. Você pode acessá-la através de Suas integrações > Detalhes da aplicação > Testes > Credenciais de teste. de teste.
4. Obtenha o seu Access Token (OAuth)
Se você é um integrador que trabalha com diversas lojas que operam com o Mercado Pago, recomendamos que faça o OAuth - autenticação entre contas*. Através do processo o vendedor autoriza o compartilhamento seguro dos seus dados com um sistema de terceiros.
O Access Token só pode ser compartilhado via OAuth. Consulte a documentação para obter mais informações.
5. Identifique a sua integração (Sponsor ID)
Ao criar uma conta no Mercado Pago, você recebe um User ID, se for usuário, ou um Cust ID, se for vendedor. Ambos são IDs únicos gerados automaticamente, e permitirão que as integrações sejam associadas a cada conta, incluindo-as nas chamadas de API.
Ao fazer integrações para terceiros, o parâmetro sponsor_id permitirá identificar os pedidos que são realizados pelo seu ponto de venda. Você deverá enviar o Sponsor ID nos chamados para a API de Pedidos Presenciais. Siga as instruções abaixo para saber como obtê-lo e incluí-lo:
- Se você ainda não fez, crie uma conta no portal do Mercado Pago.
- Obtenha o ID do usuário (Cust ID ou User ID) da sua conta acessando os detalhes da aplicação que você criou anteriormente.
- Inclua o ID da sua conta de integrador no Sponsor ID do vendedor.
- Envie o Sponsor ID em todas as transações QR, conforme mostrado em nossa Referência de API.