Chaves de API do comerciante e integração de estoque (Pro+)
Use chaves do lado do servidor criadas pelo proprietário para três rotas de API suportadas, com acesso com escopo e orçamentos de uso de armazenamento.
Nesta página
Crie uma chave com escopo
Como proprietário da loja, abra Gerenciar loja → Enterprise → Merchant API. Dê um nome à chave e selecione apenas os escopos necessários: products:read, orders:read ou stock:write. Copie o segredo uma única vez para um armazenamento seguro no servidor; ele não será exibido novamente.
Leia o contrato da API
O contrato OpenAPI público está em /openapi/merchant-v1.json. As rotas disponíveis listam produtos, listam pedidos e atualizam estoque de produtos sem chaves. Use autenticação Bearer, páginas limitadas com cursor e Idempotency-Key nas alterações de estoque. Não é uma API completa de checkout, reembolso ou provisionamento de clientes.
Respeite orçamentos e prazos de validade
As chaves criadas pelo console expiram após 90 dias. Os limites são 60 solicitações/minuto por loja e 10.000/mês no Pro ou 100.000 no Enterprise; contagem de novas tentativas. Lide com respostas 401/403/409/429 e revogue chaves não utilizadas. Transferência de proprietário, suspensão ou perda do plano podem impedir o acesso.