Pular para o conteúdo
Última atualização

Autenticação e Segurança

A Keeta trabalha com dois mecanismos:

  • OAuth 2.0 — usado pelo Software Service para chamar a API da Keeta (token Bearer obtido em POST /oauth/token).

  • apiKey — opcional, usado pela Keeta para chamar o endpoint GET /v1/merchant hospedado pelo Software Service. Se o seu endpoint exigir chave, informe-a em getMerchantURL.apiKey no onboarding.

Além do token, toda requisição do Software Service à Keeta deve carregar o header X-App-Signature (ver a seção Cálculo de Assinatura). No sentido inverso, os webhooks da Keeta também chegam assinados, permitindo validar a origem.

Modos de token

Modogrant_typeEscopo do access_tokenRenovação
App Level Tokenapp_level_tokenUm token para todas as lojas autorizadasChame POST /oauth/token de novo
Shop Level Authorization Codeshop_level_authorization_codeUm token para uma loja autorizada; troca o authorization_code fornecido pelo merchantUse grant_type=refresh_token antes de o access_token expirar
(legado)client_credentialsEquivalente ao App Level TokenMantido para integrações já homologadas