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/merchanthospedado pelo Software Service. Se o seu endpoint exigir chave, informe-a emgetMerchantURL.apiKeyno 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.
| Modo | grant_type | Escopo do access_token | Renovação |
|---|---|---|---|
| App Level Token | app_level_token | Um token para todas as lojas autorizadas | Chame POST /oauth/token de novo |
| Shop Level Authorization Code | shop_level_authorization_code | Um token para uma loja autorizada; troca o authorization_code fornecido pelo merchant | Use grant_type=refresh_token antes de o access_token expirar |
| (legado) | client_credentials | Equivalente ao App Level Token | Mantido para integrações já homologadas |