Mercado Livre

Passo a passo de como utilizar a API do Mercado Livre.

1° Passo - Criar um aplicativo

Acessar Link: https://developers.mercadolivre.com.br/devcenter

Criar nova aplicação

Informar os dados básicos da aplicação:

A URL de redirecionamento deve ser esta https://www.google.com.br e os escopos selecionados devem ser: (read, offline access, write):

Selecionar todos os tópicos disponíveis na aplicação:

2° Passo - Solicitar o Token de liberação

Acessar a aplicação, e coletar o ID do aplicativo

Copiar a URL: (https://auth.mercadolivre.com.br/authorization?response_type=code&client_id=$CLIENT_ID&redirect_uri=https://www.google.com.br)

O $CLIENT_ID de ser substituído pelo ID do aplicativo

Após copiar a URL e substituir o $CLIENT_ID e pesquisar, basta confirmar o acesso a aplicação:

3° Passo - Solicitar o Access Token

Após a autorização da aplicação, basta ir até o ERP, no formulário de configurações de integração para solicitar o Token de liberação e logo após o Access Token

Antes de solicitar o token de acesso, é preciso realizar as configurações dos campos do Mercado Livre, principalmente o Caminho das Credenciais. Lembrando que as credenciais precisam estar no servidor, pois em caso de utilização do Webhook as credenciais serão utilizadas:

Pronto para solicitar o token de liberação:

Ao clicar em Gerar Token Autorização, será redirecionado para a URL de redirecionamento informada no aplicativo do mercado livre:

Lembre-se de guardar copiar a URL, pois ela contém o token de liberação para solicitar o Access Token

Com a URL do token de liberação em mãos, basta informa-la em Identificação Token Temporário

Para o próximo passo basta selecionar o aplicativo, no meu caso é o "Teste cobrança". Mas como será o seu primeiro acesso basta clicar em "Nova Aplicação". Você será redirecionado para a tela de criação de uma nova aplicação, basta informar os dados (Nome, Descrição e icone. Icones são opcionais).

Cadastro nova aplicação

Logo abaixo você deve selecionar quais APIs o seu aplicativo ira obter, os aplicativos podem possuir APIs de cobranças ou pagamentos.

Apis para aplicação cobrança

Apis para aplicação pagamento

Com o aplicativo selecionado basta ir na barra de menus no canto esquerdo.

Barra de menus do aplicativo BB

Para obter as credenciais para poder realizar os testes ou até mesmo as credencias de produção, basta clicar em credenciais.

Credenciais de teste dados ocultos

4° Passo - Acessar Documentação e Ambiente de Teste

Para acessar a documentação ou ambiente de teste, basta voltar para o Dashboard inicial clicando na barra de menus ao lado esquerdo e ir em "Dashboard". No Dashboard basta ir em "Documentação" ou "SandBox" (Para o ambiente de teste).

Dashboard

Ao clicar em "Documentação", para obter os dados de teste, basta ir ao menu lateral esquerdo e clicar em "API Cobrança -> Homologação e testes" (Dados da API de cobrança) por exemplo.

Homologação e teste

Ao acessar essa aba ao rolar para baixo você tem acesso aos dados fictícios, como também, exemplo de como montar a requisição.

Dados ficticios documentação

Dados ficticios requisicao

Ao clicar em "SandBox", para obter acesso ao ambiente de testes do Banco do Brasil, basta ir ao menu lateral esquerdo e clicar em "API'S" e escolher a API que deseja testar, você pode utilizar o ambiente de testes para entender o processo ou ir direto ao ERP.

Barra Lateral SandBox

Ao clicar em "Cobrança" por exemplo, a tela abaixo será exibida:

Porém, antes de utilizar a API você precisa Autorizar as suas credenciais, basta clicar em "Authorize":

Tela de autorização SanxBox

Basta informar o seu Client-Id e Client-Secret e selecionar os escopos a ser utilizado, pode selecionar os dois escopos, pois será necessário para utilizar nos testes. Após isso basta autorizar.

5° Passo - Produção

Para colocar a aplicação em Produção basta ir na barra de menus no canto esquerdo e clicar em Produção.

Colocando o aplicativo BB em produção

Ao clicar a tela de inicio para colocar o aplicativo em produção será exibida, basta seguir os passos.

Inicio da produção para o aplicativo BB

6° Passo - Configurar WebHook ERP

Para o funcionamento do webhook é necessário algumas informações no ERP:

Informar o número de convenio da conta e também a quantidade de dias acordada na contratação do convenio para a data de crédito, considerando feriados e finais de semana.

É necessário informar no cadastro de banco o código da ocorrência que vai ser utilizada para a baixa operacional das cobranças recebidas no evento do webhook:

Já nas informações da aplicação, é preciso informar as informações do banco de dados para funcionamento da aplicação, que se encontra na pasta XmlConfig no arquivo WH_DpSettings.xml:

Já no arquivo web.config é preciso parametrizar o caminho do arquivo de configurações e também aonde o arquivo de log será gerado, e um usuário para ser utilizado no log de alterações do movimento que será gerado:

7° Passo - Configurar WebHook Banco do Brasil

Na plataforma do Banco do Brasil é preciso seguir os seguintes passos:

Entrar no aplicativo, clicar no menu lateral esquerdo em webhook:

Clicar em Cadastrar Evento e inserir as informações necessárias para o funcionamento, assim como escolher a API a ser utilizada, o convenio, a URL de callback e o email para notificações de problemas e o tipo de evento.

Segue os IPs externos utilizados pelo Webhook dos 2 datacenters do banco do brasil:

  CCT1: 170.66.14.184
  CCT2: 170.66.196.181 / 170.66.196.114 - 115