# Programadores e parceiros · Feitora

> API REST de administração, webhooks assinados, servidor MCP e Loja de apps com OAuth. Constrói para os lojistas da Feitora.

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 parceiros Centro 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. Cria o token com as permissões certas
- 2. Chama a API ou liga o MCP de administração
- 3. Subscreve os eventos de que precisas
- 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/paid orders/create products/update fulfillments/update refunds/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 parceiros Documentação