HTTPS · OAuth 2.0 · Webhooks assinados

Integrações oficiais com marketplaces e plataformas de e-commerce

O MarginPro se conecta via OAuth 2.0 às APIs oficiais dos marketplaces para importar produtos, sincronizar pedidos e consolidar dados financeiros (taxas, comissões, custos de anúncios) em tempo real.

Fluxo técnico

Como funciona a integração

01

Iniciar conexão

O seller clica em “Conectar” dentro do MarginPro e escolhe o marketplace.

02

OAuth oficial

Redirect ao domínio oficial (auth.mercadolivre.com, partners.shopify.com, etc.) para autorização.

03

Callback assinado

O marketplace devolve um authorization code via redirect HTTPS ao MarginPro.

04

Sync em tempo real

Trocamos o code por access_token, armazenamos com escopo mínimo e disparamos sync + webhooks.

Autorização OAuth 2.0

Cada seller autoriza o MarginPro na tela oficial do marketplace. Nenhuma senha é armazenada — recebemos apenas um access_token vinculado aos escopos aprovados, que pode ser revogado a qualquer momento pelo painel do próprio marketplace.

  • Escopos mínimos (least privilege) por integração.
  • Tokens armazenados criptografados no banco.
  • Webhooks validados com HMAC / assinatura do provedor.
  • Row-Level Security por organização no banco.
https://auth.mercadolivre.com.br/authorization
Mercado Livre
MarginPro solicita acesso
à sua conta Mercado Livre
Permissões solicitadas
  • Ler seus pedidos e faturamento
  • Ler seus anúncios e estoque
  • Receber notificações de eventos
Conexão segura via OAuth 2.0

Catálogo

Marketplaces e plataformas suportadas

Só listamos capacidades já implementadas em produção. Recursos em rollout ou aguardando aprovação da plataforma oficial são marcados explicitamente.

Mercado Livre
Mercado Livre
Brasil · MLB
Integração ativa

Marketplace líder na América Latina

Escopos OAuth
  • Leitura de pedidos
    orders/search, orders/{id}, billing
  • Anúncios e estoque
    items, /users/me/items/search
  • Mercado Ads
    advertising/product_ads — spend e métricas
  • Notificações
    orders_v2, items, messages, shipments
PedidosProdutosEstoqueMercado AdsTaxas FULLWebhooks
Nuvemshop
Brasil · LATAM
Integração ativa

Plataforma de e-commerce líder na LATAM

Escopos OAuth
  • read_orders
    Pedidos, pagamentos e envios
  • read_products
    Catálogo, variantes e estoque
  • Webhooks HMAC-SHA256
    order/created, order/paid, product/updated
PedidosProdutosEstoqueWebhooks assinados
Shopify
Global
Integração ativa

Plataforma de e-commerce global

Escopos OAuth
  • read_orders
    Admin API — pedidos e pagamentos
  • read_products
    Catálogo, variantes e coleções
  • read_inventory
    Níveis de estoque por localização
PedidosProdutosEstoque
Meta Ads
Global · Meta Business
Integração ativa

Facebook & Instagram Ads via Marketing API

Escopos OAuth
  • ads_read
    Campanhas, ad sets e insights (spend, impressions, clicks, CPA)
  • business_management
    Business Accounts e contas de anúncios autorizadas
Spend por campanhaROASImpressõesCliquesCPA
TikTok Shop
TikTok Shop
Brasil · BR
OAuth ativo · sync em rollout

Social commerce com checkout integrado

Escopos OAuth
  • order.read
    order/search, order/detail
  • product.read
    product/search, inventory
OAuth conectadoSync de pedidos em rollout
Shopee
Shopee
Brasil · BR
Em breve

Maior marketplace do sudeste asiático e LATAM

Escopos OAuth
  • order.read
    Leitura de pedidos via Shopee Open Platform
  • product.read
    Catálogo e estoque
  • logistics.read
    Tracking e envios
PedidosProdutosEstoqueLogística

Segurança & compliance

Boas práticas em toda a stack de integração

Tokens criptografados

access_token e refresh_token armazenados com criptografia no banco.

Escopos mínimos

Solicitamos apenas o necessário para operar cada integração.

Webhooks assinados

Assinatura HMAC-SHA256 (Nuvemshop) e validação por marketplace.

RLS por organização

Cada seller vê apenas seus próprios dados via Row-Level Security.

HTTPS obrigatório

Todos os callbacks OAuth e endpoints públicos são exclusivamente TLS.

Refresh automático

Renovação de tokens antes do vencimento — sem intervenção do seller.

Auditoria

Log completo de eventos de conexão, sync e revogação.

Revogação simples

Sellers desconectam a qualquer momento pelo painel ou pelo marketplace.

Conecte seus canais em minutos

Teste grátis por 14 dias e conecte quantos marketplaces quiser via OAuth oficial.