Criar conta de desenvolvedor

Cadastrar aplicativo

• Centralizado (SaaS) - quando seu software está disponibilizado em um ambiente na nuvem e ele tem acesso a todas as lojas nessa única instância centralizada;
• Distribuído (On-premises) - quando seu software está disponibilizado no ambiente da loja e apenas essa instância tem permissão de acesso a essa loja;

Boas Práticas de Cadastro de Aplicativo

• Nome do Aplicativo: Escolha um nome que seja único, fácil de lembrar e que reflita a funcionalidade do seu aplicativo. Evite nomes genéricos ou muito longos.
• URL do aplicativo: Forneça o URL do site oficial do aplicativo. Certifique-se de que o site está atualizado e contém informações relevantes sobre o aplicativo.
• Descrição: Escreva um slogan ou frase de impacto que descreva o seu aplicativo. A descrição deve ser cativante e dar aos usuários uma ideia rápida do que o aplicativo faz.
• Descrição completa: Forneça uma descrição detalhada do aplicativo, explicando como o aplicativo funciona, quais problemas ele resolve e por que os usuários devem escolhê-lo.
• Categoria: Selecione a categoria que melhor descreve o seu aplicativo. Isso ajudará os usuários a encontrar o seu aplicativo quando estiverem navegando pelo marketplace.
• Visibilidade: Selecione se deseja tornar o aplicativo público (visível no marketplace) ou não.
• Logo: Faça o upload de uma imagem que represente o seu aplicativo. A imagem deve ser clara, atraente e de alta qualidade e evite usar texto na imagem.
• Galeria de Imagens: Inclua capturas de tela que destacam as principais funcionalidades e características do seu aplicativo. As imagens devem ser claras, de alta qualidade e representar com precisão o que o usuário pode esperar ao usar o aplicativo. Evite usar imagens genéricas ou irrelevantes.

Utilizando as APIs

• Tipo de cadastro no Portal do Desenvolvedor
• Geração de pedidos de teste
• Processo de homologação
• Disponibilidade dos módulos das APIs

• Food: Para integrações focadas em entregas de comida.
• Grocery: Para integrações focadas em encomendas de mercado.

Homologar aplicativo

Categorias e módulos

Critérios de Homologação

Solicitar acessos

Aplicativo Centralizado

1. Acesse o menu Meus Apps no Portal do Desenvolvedor e selecione o aplicativo
2. Na aba Permissões, localize a loja pelo id ou pelo CNPJ
3. Confirme os dados da loja e envie a solicitação
4. O responsável pela loja receberá a solicitação e, assim que ela for aprovada através do Portal do Parceiro, você terá acesso aos dados dessa loja (de acordo com os módulos informados no cadastro do aplicativo) mas é preciso gerar um novo accessToken.

Aplicativo Distribuído

1. Você deve disponibilizar no seu aplicativo um botão/link para o usuário conceder o acesso.
2. Quando o usuário clicar nesse botão, você deve gerar um código (userCode) através do endpoint authentication/v1.0/oauth/userCode
3. Disponibilize a URL (verificationUrlComplete) e o código (userCode) obtidos na requisição anterior para o usuário.
4. O usuário deve clicar nessa URL (verificationUrlComplete) que deve abrir o Portal do Parceiro que exige autenticação.
5. O usuário (responsável pela loja) visualizará um modal "Autorizar Aplicativo" e depois de clicar em "Autorizar" receberá um código de autorização (authorizationCode).
6. O usuário deve copiar o código de autorização (authorizationCode) e configurá-lo no PDV.
7. Com o código de autorização (authorizationCode) você consegue autenticar através do endpoint de authentication/v1.0/oauth/token.

curl -X POST 'https://merchant-api.ifood.com.br/authentication/v1.0/oauth/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d '{
      "grantType": "authorization_code",
      "clientId": "d28ed85f-9b43-4555-a7c1-9b0df25e9999",
      "clientSecret":"s18lm6m5uwatgihxdl6h9pr0j11ugh9sjjs9a127gohyyqsitzulx12p5b5kty1l59orgbaryy7r1545ty6se9ljnlvea609999",
      "authorizationCode": "LHQX-ZZZZ",
      "authorizationCodeVerifier": "f3u8geu9uq31k7l8co7kct2ow3ctxu1ujoaoewgotj7gc60ji1r3zmzhy13tmcp577gyck4lka3c5852k2jg1h1gkpr8nca9999"
    }