---
title: "Obter access token"
method: POST
path: "/oauth2/token"
---

# Obter access token

`POST /oauth2/token`

## Request

- Base URL: `https://sandbox.api.pagseguro.com`
- URL: `https://sandbox.api.pagseguro.com/oauth2/token`
- Auth: none required

## Headers

- `Authorization` string
- `X_CLIENT_ID` string
- `X_CLIENT_SECRET` string

## Request body

- object
  - `grant_type` 'sms' | 'authorization_code' | 'challenge', required: Indica o tipo de autenticação utilizada.
  - `code` string: Código que foi enviado para URL no momento da permissão usuário (Connect Authorization). Obrigatório quando `grant_type = authorization_code`.
  - `sms_code` string: Código SMS enviado para o número cadastrado na base PagSeguro (Connect SMS). Obrigatório quando `grant_type = sms`.
  - `redirect_uri` string: URL de redirecionamento do cliente, deve ser a mesma do momento da permissão. Obrigatório quando `grant_type = authorization_code`.
  - `email` string: E-mail do cliente PagBank que deseja conceder permissão para o parceiro efetuar ações em nome dele na plataforma PagSeguro. Obrigatório quando `grant_type = sms`.
  - `scope` string: Nome do escopo. Quando `grant_tpe` for informado como `challenge`, obrigatoriamente use `certificate.create` para solicitar a criação de um certificado digital.
  - `authorization_id` string: Identifica a autorização obtida ao solicitar a autorização via SMS.

## Response `200`

200

- union
  - object
    - `token_type` string
    - `access_token` string
    - `expires_in` string
    - `refresh_token` string
    - `scope` string
    - `account_id` string
  - object
    - `token_type` string
    - `access_token` string
    - `expires_in` string
    - `refresh_token` string
    - `scope` string
    - `account_id` string
  - object
    - `access_token` string
    - `token_type` string
    - `expires_in` integer
    - `scope` string
    - `challenge` string

---

[API](https://skmtc.dev/pagbank/apis/nova-plataforma-sandbox.md) - [All operations](https://skmtc.dev/pagbank/apis/nova-plataforma-sandbox/llms.txt) - [OpenAPI document](https://skmtc.dev/pagbank/apis/nova-plataforma-sandbox/revisions/0838a2b3f755?raw)