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

# Callback de Autorização

> Endpoint de retorno (callback) chamado pela plataforma do marketplace após o consentimento do usuário (fluxo OAuth).

Normalmente, não é você quem chama esta rota. O marketplace injetará os parâmetros de `code`, `state` e o ID de identificação na requisição para que o OmniDom armazene os tokens e crie uma nova `MarketplaceConnection`.

### Query Parameters

<ParamField query="code" type="string" required>
  Authorization code cedido temporariamente pela plataforma para obter o Token.
</ParamField>

<ParamField query="state" type="string" required>
  Token de estado que o OmniDom enviou para evitar ataques CSRF e rastrear a sessão do tenant.
</ParamField>

<ParamField query="shop_id" type="string">
  Informação adicional que certas integrações como Shopee requerem.
</ParamField>

### Response

<ResponseExample>
  ```json Response theme={null}
  {
    "message": "Connection successful",
    "channelId": "488fa4bd-9e19-4eb5-b461-abeb38a0f9de"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml get /integrations/callback
openapi: 3.0.0
info:
  title: Hub Marketplace API
  description: API for managing marketplace listings and keys
  version: '1.0'
  contact: {}
servers: []
security: []
tags:
  - name: listings
    description: ''
paths:
  /integrations/callback:
    get:
      tags:
        - Integrations
      operationId: IntegrationsController_callback
      parameters:
        - name: code
          required: true
          in: query
          schema:
            type: string
        - name: state
          required: true
          in: query
          schema:
            type: string
        - name: shop_id
          required: true
          in: query
          schema:
            type: string
      responses:
        '200':
          description: ''

````