CLIENT_ID e o CLIENT_SECRET a serem injetados nas variáveis de ambiente do Backend.
1. Mercado Livre Developers
Você precisará de uma conta no Mercado Livre habilitada como Developer.1
Acessar o Painel
Acesse Mercado Livre Developers e faça login.
2
Criar Nova Aplicação
Clique em Criar Aplicação.
- Nome: OmniDom Hub (ou outro de sua preferência).
- Descrição: Hub de integração de Vendas e Estoque.
- URL da Aplicação (URI de redirecionamento): OBRIGATÓRIO! Deve ser a URL da sua API de produção acrescida do caminho do callback. Exemplo:
https://sua-api.up.railway.app/integrations/oauth/meli/callback.
3
Permissões
Solicite todos os Escopos (Scopes) de permissão necessários: Leitura de dados offline, Publicação de produtos, Mensageria, Gestão de Pedidos.
4
Webhooks (Tópicos de Notificação)
O ML envia notificações em tempo real. Você deve configurar a Callback URL para notificações:
https://sua-api.up.railway.app/integrations/webhooks/meli
Marque os tópicos exigidos (ex: orders, items, questions, payments).5
Injetar no .env
Após criar, o painel mostrará o App ID e o Client Secret. Copie-os as coloque nas variáveis do railway (
MELI_APP_ID, MELI_SECRET).2. Shopee Open Platform
A Shopee possui um processo ligeiramente diferente: exigem verificação da conta do desenvolvedor.1
Acesse a Open Platform
Vá para a Shopee Open Platform e crie sua conta de Partner/Developer.
2
Crie um App (Console)
No Developer Console, crie um App do Tipo Seller In-house App (se for para uso da sua própria conta) ou Third-Party App (se você for revender como SaaS multi-tenant a terceiros).
3
Configurar URLs
- App Callback URL:
https://sua-api.up.railway.app/integrations/oauth/shopee/callback - Push Mechanism URL (Webhooks):
https://sua-api.up.railway.app/integrations/webhooks/shopee
4
Permissões
Adicione as permissões (Order Management, Product, Logistics, Returns).
5
Injetar no .env
Copie o Partner ID e a Partner Key. Coloque-os na sua instância Railway correspondente (
SHOPEE_PARTNER_ID, SHOPEE_SECRET_KEY).