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).
Logo abaixo você deve selecionar quais APIs o seu aplicativo ira obter, os aplicativos podem possuir APIs de cobranças ou pagamentos.
Com o aplicativo selecionado basta ir na barra de menus no canto esquerdo.
Para obter as credenciais para poder realizar os testes ou até mesmo as credencias de produção, basta clicar em credenciais.
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).
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.
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.
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.
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":
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.
Ao clicar a tela de inicio para colocar o aplicativo em produção será exibida, basta seguir os passos.
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