Autenticação

Todo endpoint da Merchant API V3 exige um token OAuth2 no header Authorization. O passo a passo para obter e renovar o token está em Autenticação.

Endpoint	Para quê
`POST /authentication/v1/oauth/token`	Obter o token: `client_credentials` (distribuição direta), `authorization_code` (interativa) ou `refresh_token`.
`GET /authentication/v1/oauth/token/info`	Ver o app, os scopes e o tempo restante do token enviado.
`POST /authentication/v1/oauth/introspect`	Verificar se um token está ativo.
`POST /authentication/v1/oauth/revoke`	Revogar um token antes de expirar.

Com o token em mãos, envie-o em toda chamada:

curl 'https://api.deliveryvip.com.br/merchant/v3/events:polling' \
  --header 'Authorization: Bearer {token}'

const response = await fetch('https://api.deliveryvip.com.br/merchant/v3/events:polling', {
  headers: { Authorization: `Bearer ${token}` },
})

response = requests.get(
    "https://api.deliveryvip.com.br/merchant/v3/events:polling",
    headers={"Authorization": f"Bearer {token}"},
)

Endpoints	Scope exigido
Pedidos, eventos, catálogo, indoor, descontos e ferramentas	`od.all`
Configuração de fidelidade (`/loyalty/config`)	`dv.loyalty`

Status	Quando
`401 Unauthorized`	Token ausente, inválido ou expirado.
`403 Forbidden`	Token válido, mas sem o scope exigido pelo endpoint.
`404 Not Found`	A loja ou o recurso não existe, ou o token não tem acesso a essa loja.