# Notificação de mudança de autorização

**Este endpoint é implementado por você** (Host: **Software Service**). A Keeta chama quando um merchant adiciona ou cancela a autorização de uma loja.
**Configuração:** no Dev Portal, seção de webhooks. Configure apenas para **Formal Store**: evento **1301** = nova autorização; **1302** = cancelamento de autorização.
Header: `X-App-Signature` (obrigatório).
| Campo | Tipo | Descrição |
|  --- | --- | --- |
| `clientId` | integer | ID da aplicação |
| `authId` | string | ID da sessão de autorização |
| `opType` | integer | `1` = autorização adicionada; `2` = autorização cancelada |
| `shopId` | integer | ID da loja |
| `shopName` | string | Nome da loja |
| `createTime` | integer | Timestamp do evento em milissegundos |

**Requisitos:** responder `200` em até ~5 s, com JSON contendo `code` e `message`. Boas práticas: idempotência por `authId` + `opType`, processar a regra de negócio de forma assíncrona, registrar logs e monitorar falhas. Respostas previstas: `200`, `400` (formato inválido), `500`.

Endpoint: POST /webhook/authorization
Version: v.1.0.7

## Header parameters:

  - `X-App-Signature` (string, required)

## Request body:

  - `application/json` (unknown)
    Authorization status change notification data

## Request fields (application/json):

  - `clientId` (integer, required)
    ID do aplicativo que identifica o aplicativo do Software Service
    Example: 2666245991

  - `authId` (string, required)
    ID de autorização que identifica exclusivamente uma sessão de autorização.  Cada autorização gera um authId único. Há duas formas de obter o authId:  1. Redirecionamento de autorização do merchant: o authId é incluído na URL de redirecionamento  2. Webhook de autorização da Keeta: o authId é enviado no payload do webhook  Consulte o fluxo específico em: [Merchant Self-serve Authorization](/apis/opendelivery/merchant-self-serve-authorization)
    Example: 41008

  - `opType` (integer, required)
    Tipo de operação: 1 = adicionar autorização, 2 = cancelar autorização
    Enum: "1", "2"

  - `shopId` (integer, required)
    ID da loja
    Example: 478268

  - `shopName` (string, required)
    Nome da loja
    Example: 10 Shanghai

  - `createTime` (integer, required)
    Timestamp do evento em milissegundos
    Example: 1753151456973

## Response 200:

  - `200` (unknown)
    Successfully processed webhook notification

## Response 400:

  - `400` (unknown)
    Invalid webhook data format

## Response 400 fields (application/json):

  - `status` (integer, required)
    Código de resposta; 0 indica sucesso
    Example: 0

  - `title` (string, required)
    Mensagem de resposta
    Example: success

## Response 500:

  - `500` (unknown)
    Internal server error processing webhook

## Response 500 fields (application/json):

  - `status` (integer, required)
    Código de resposta; 0 indica sucesso
    Example: 0

  - `title` (string, required)
    Mensagem de resposta
    Example: success

