---
updatedAt: 2026-08-26T16:35:37.000Z
agentTools:
  projectIndex: https://developer.pagbank.com.br/v1.0/llms.txt
---

# Consultando uma autorização pelo seu código de autorização

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "pscore-sandbox",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://ws.sandbox.pagseguro.uol.com.br"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/v2/authorizations/{authorizationCode}?{appId={appId}&appKey={appKey}}": {
      "get": {
        "summary": "Consultando uma autorização pelo seu código de autorização",
        "description": "",
        "operationId": "aplicacoes-consultando-uma-autorizacao-pelo-seu-codigo",
        "parameters": [
          {
            "name": "appId",
            "in": "path",
            "description": "ID da Aplicação - Presença: Obrigatória. Tipo: Texto. Formato: Uma sequência de até 60 caracteres.",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "appKey",
            "in": "path",
            "description": "Especifica o token correspondente à aplicação PagSeguro que está realizando a requisição. Especifica o token correspondente à aplicação PagSeguro que está realizando a requisição. - Presença: Obrigatória. Tipo: Texto. Formato: Uma sequência de 32 caracteres.",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "authorizationCode (após authorizations /)",
            "in": "path",
            "description": "Código que identifica a autorização a ser consultada/cancelada. - Presença: Obrigatória na consulta de uma autorização. Tipo: Texto. Formato: Uma sequência de 32 caracteres.",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "authorization",
                  "code",
                  "creationDate",
                  "reference",
                  "account",
                  "publicKey",
                  "permissions",
                  "permission",
                  "CREATE_CHECKOUTS",
                  "RECEIVE_TRANSACTION_NOTIFICATIONS",
                  "SEARCH_TRANSACTIONS",
                  "MANAGE_PAYMENT_PRE_APPROVALS",
                  "DIRECT_PAYMENT",
                  "status",
                  "PENDING",
                  "APPROVED",
                  "DENIED",
                  "lastUpdate"
                ],
                "properties": {
                  "authorization": {
                    "type": "object",
                    "description": "Código de autorização. **Tipo:** Texto",
                    "properties": {}
                  },
                  "code": {
                    "type": "string",
                    "description": "Código da permissão. **Tipo:** Texto."
                  },
                  "creationDate": {
                    "type": "string",
                    "description": "Data da criação da autorização **Tipo:** Texto."
                  },
                  "reference": {
                    "type": "object",
                    "description": "Identificador que foi usado para fazer referência à autorização no momento de sua requisição. **Tipo:** Data/Hora. **Formato:** YYYY-MM-DDThh:mm:ss.sTZD**, o formato oficial do W3C para datas. Veja mais sobre [formatação de datas](https://www.w3.org/TR/NOTE-datetime)..",
                    "properties": {}
                  },
                  "account": {
                    "type": "object",
                    "description": "Início do nó que informa a publicKey do seller.",
                    "properties": {}
                  },
                  "publicKey": {
                    "type": "string",
                    "description": "Chave pública do vendedor. **Tipo:** Texto."
                  },
                  "permissions": {
                    "type": "object",
                    "description": "Permissões que o dono da aplicação solicita ao seller.",
                    "properties": {}
                  },
                  "permission": {
                    "type": "object",
                    "description": "Permissões que o dono da aplicação solicita ao seller",
                    "properties": {}
                  },
                  "CREATE_CHECKOUTS": {
                    "type": "string",
                    "description": "A aplicação poderá direcionar compradores para o PagSeguro e intermediar pagamentos para você."
                  },
                  "RECEIVE_TRANSACTION_NOTIFICATIONS": {
                    "type": "string",
                    "description": "A aplicação poderá receber e consultar notificações das transações que ela intermediou para você."
                  },
                  "SEARCH_TRANSACTIONS": {
                    "type": "string",
                    "description": "A aplicação poderá consultar as transações que ela intermediou para você."
                  },
                  "MANAGE_PAYMENT_PRE_APPROVALS": {
                    "type": "string",
                    "description": "A aplicação poderá gerenciar e utilizar pré-aprovações de pagamentos para você."
                  },
                  "DIRECT_PAYMENT": {
                    "type": "string",
                    "description": "A aplicação poderá gerenciar pagamentos via checkout transparente."
                  },
                  "status": {
                    "type": "object",
                    "description": "Status da permissão do cliente. **Tipo:** Texto.",
                    "properties": {}
                  },
                  "PENDING": {
                    "type": "string",
                    "description": "Pendente de aprovação."
                  },
                  "APPROVED": {
                    "type": "string",
                    "description": "Aprovado pelo cliente."
                  },
                  "DENIED": {
                    "type": "string",
                    "description": "Negado pelo cliente"
                  },
                  "lastUpdate": {
                    "type": "string",
                    "description": "Data/hora em que ocorreu a última alteração no status da permissão. **Tipo:** Texto."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/xml": {
                "examples": {
                  "Result": {
                    "value": "<authorization>\n   <code>9D7FF2E921216F1334EE9FBEB7B4EBBC</code>\n   <creationDate>2011-03-30T14:20:13.000-03:00</creationDate>\n   <reference>REF1234</reference>\n   <account>\n      <publicKey>PUB9B3227C6228848ACBFFCF46DD04C3211</publicKey>\n   </account>\n   <permissions>\n      <permission>\n         <code>CREATE_CHECKOUTS</code>\n         <status>APPROVED</status>\n         <lastUpdate>2011-03-30T15:35:44.000-03:00</lastUpdate>\n      </permission>\n      <permission>\n         <code>SEARCH_TRANSACTIONS</code>\n         <status>APPROVED</status>\n         <lastUpdate>2011-03-30T14:20:13.000-03:00</lastUpdate>\n      </permission>\n   </permissions>\n</authorization>"
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "Unauthorized"
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```