## Autenticação 

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 [Cálculo de Assinatura](/apis/opendelivery/signature-calculation)). No sentido inverso, os webhooks da Keeta também chegam assinados, permitindo validar a origem.

### Modos de token

| 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 |