> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Documentação das APIs da DeliveryVip, em português. Regras que mais quebram integrações: (1) Merchant API: faça polling em GET /merchant/v3/events:polling no máximo a cada 30 s por token; confirme todo evento recebido com POST /merchant/v3/events/acknowledgment e corpo [{"id": "<eventId>"}] (o campo lido é id, não eventId), inclusive eventos repetidos ou que o sistema não trata; deduplique por eventId; o evento é só um aviso, busque o pedido na orderURL. (2) Tokens client_credentials valem 24 h e não têm refresh_token: peça outro ao receber 401. (3) Webhooks: valide a assinatura HMAC sobre o corpo bruto e responda 2xx rápido; o polling é a reconciliação. (4) Open Delivery: host od.deliveryvip.com.br, um client_secret por loja, datas em UTC. (5) Fidelidade: o operador implementa 5 rotas assinadas com HMAC e chama o config push; o estorno precisa ser idempotente. (6) Partner API: scope dv.partner. Não invente endpoints: use a referência gerada das specs OpenAPI.

# Revogar token

> Revoga um access token ou refresh token antes da expiração (RFC 7009). O token precisa pertencer ao cliente autenticado. Responde 200 também quando o token é desconhecido ou já estava inválido.



## OpenAPI

````yaml https://app.deliveryvip.com.br/swaggers/authentication.yaml post /authentication/v1/oauth/revoke
openapi: 3.0.3
info:
  version: v1
  title: API de Autenticação DeliveryVip
  description: >-
    Emissão e gestão dos access tokens OAuth 2.0 usados nas demais APIs da
    DeliveryVip. Os tokens são opacos (não são JWT) e devem ser enviados no
    header `Authorization: Bearer <token>`. Todas as requisições ao endpoint de
    token devem usar `Content-Type: application/x-www-form-urlencoded`.
servers:
  - url: https://api.deliveryvip.com.br
    description: Produção
security: []
tags:
  - name: OAuth
    description: Emissão, renovação, revogação e inspeção de tokens OAuth 2.0.
paths:
  /authentication/v1/oauth/revoke:
    post:
      tags:
        - OAuth
      summary: Revogar token
      description: >-
        Revoga um access token ou refresh token antes da expiração (RFC 7009). O
        token precisa pertencer ao cliente autenticado. Responde 200 também
        quando o token é desconhecido ou já estava inválido.
      operationId: revokeToken
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - token
              properties:
                token:
                  description: Access token ou refresh token a revogar.
                  type: string
                  example: 2YotnFZFEjr1zCsicMWpAA
                client_id:
                  description: Identificador do cliente. Pode ser enviado via HTTP Basic.
                  type: string
                  example: seu-client-id
                client_secret:
                  description: Segredo do cliente. Pode ser enviado via HTTP Basic.
                  type: string
                  example: seu-client-secret
      responses:
        '200':
          description: Token revogado (ou já inválido). Corpo vazio (`{}`).
          content:
            application/json:
              schema:
                type: object
        '403':
          description: >-
            Cliente não autenticado ou sem permissão para revogar o token
            informado (`unauthorized_client`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/oauthError'
      security:
        - basicAuth: []
        - {}
components:
  schemas:
    oauthError:
      type: object
      description: Erro no formato OAuth 2.0 (RFC 6749, seção 5.2).
      properties:
        error:
          type: string
          description: Código do erro.
          example: invalid_client
        error_description:
          type: string
          description: Descrição legível do erro.
          example: A autenticação do cliente falhou.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: '`client_id` como usuário e `client_secret` como senha.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.