Saltar para o conteúdo
Feitora
Entrar

Programadores e parceiros

Constrói para os lojistas portugueses.

Uma API REST completa, webhooks assinados, servidores MCP para agentes de IA e uma Loja de apps com OAuth. Tudo documentado em português.

Entrar na área de parceirosCentro de ajuda

API REST de administração

Produtos, encomendas, clientes, inventário, descontos e mais em /api/admin/v1, com especificação OpenAPI em cada loja.

  • Tokens fta_… com permissões por recurso
  • Paginação, filtros e erros consistentes
  • Limites de pedidos por plano

Webhooks

Recebe eventos quando algo muda na loja, assinados com HMAC-SHA256 no cabeçalho X-Feitora-Hmac-Sha256.

  • orders/paid, products/update, refunds/create…
  • Novas tentativas com backoff durante ~24 h
  • Webhooks RGPD obrigatórios para apps

MCP — agentes de IA

Cada loja tem um servidor MCP público para assistentes de compras e um MCP de administração para ligar o Claude Desktop ou o Claude Code à tua loja.

  • /api/mcp e /.well-known/mcp.json
  • search_catalog, update_cart, get_checkout_url…
  • MCP de administração com o mesmo token da API

Loja de apps

Publica apps para todos os lojistas da Feitora: instalação por OAuth com consentimento em linguagem simples, apps dentro do painel e cobranças na fatura Feitora.

  • client_id e client_secret por app
  • Apps incorporadas com session token e ponte postMessage
  • Revisão pela DTEC antes de publicar

Em cinco minutos

Do token ao primeiro pedido

O lojista cria uma app personalizada em Definições → Apps e API, escolhe as permissões e copia o token. A partir daí é HTTP simples — ou MCP, se preferires falar com a loja através de um agente.

  1. 1. Cria o token com as permissões certas
  2. 2. Chama a API ou liga o MCP de administração
  3. 3. Subscreve os eventos de que precisas
  4. 4. Valida a assinatura HMAC de cada webhook
API REST
GET /api/admin/v1/orders
Authorization: Bearer fta_••••

{
  "orders": [{
    "name": "#1042",
    "financial_status": "paid",
    "total": 34.9
  }]
}
Webhooks assinados (HMAC)
orders/paidorders/createproducts/updatefulfillments/updaterefunds/create
Loja de apps
Stock em Foco
Instalada por OAuth · 5,00 €/mês
claude_desktop_config.json
{
  "mcpServers": {
    "a-minha-loja": {
      "command": "npx",
      "args": ["-y", "mcp-remote",
        "https://aminhaloja.feitora.pt/api/admin/mcp",
        "--header", "Authorization:Bearer ${FEITORA_TOKEN}"]
    }
  }
}

Comércio por agentes

A tua loja a falar com o Claude.

Com o MCP de administração, o lojista pergunta ao Claude Desktop ou ao Claude Code pelas vendas da semana, corrige preços ou prepara descontos — com as permissões do token. O MCP público da loja deixa os assistentes de compras pesquisar o catálogo e montar o carrinho.

IA e comércio por agentes

Publica a tua app na Loja de apps da Feitora.

Cria a conta de parceiro, regista a app (client_id e client_secret), testa numa loja de desenvolvimento e submete para revisão. Há uma app de exemplo completa para começares.

Área de parceirosDocumentação