---
title: "Gerar token de acesso"
url: "https://devcenter.stone.com.br/apis/stone-catalog/versions/502db258-cb08-4b38-8af1-b96a688b9a9e/operations/generateExternalIdpToken"
---

> Full API specification: https://devcenter.stone.com.br/apis/stone-catalog/versions/502db258-cb08-4b38-8af1-b96a688b9a9e.md

# Gerar token de acesso

`POST` `/auth/realms/payments/oauth2/token`

Operation ID: `generateExternalIdpToken`

Gera um Bearer token usando client_credentials flow do Cognito. Use o client_id e client_secret da aplicação fornecidos pelo time. O token retornado deve ser enviado como `Authorization: Bearer <token>` nas chamadas à API.

## Request body (required)

Content types: `application/x-www-form-urlencoded`

## Responses

- `200` - Token gerado com sucesso
- `400` - Credenciais inválidas ou parâmetros incorretos

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Stone Catalog API
  version: 1.0.0
servers:
  - url: https://sdx.api.stone.com.br/v1/catalog
    description: Ambiente de Desenvolvimento (SDX)
  - url: https://api.stone.com.br/v1/catalog
    description: Ambiente de Produção (PRD)
paths:
  /auth/realms/payments/oauth2/token:
    post:
      tags:
        - Authentication
      summary: Gerar token de acesso
      description: "Gera um Bearer token usando client_credentials flow do Cognito.
        Use o client_id e client_secret da aplicação fornecidos pelo time. O
        token retornado deve ser enviado como `Authorization: Bearer <token>`
        nas chamadas à API."
      operationId: generateExternalIdpToken
      servers:
        - url: https://sdx.api.stone.com.br
          description: SDX
        - url: https://api.stone.com.br
          description: PRD
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - grant_type
                - client_id
                - client_secret
              properties:
                grant_type:
                  type: string
                  enum:
                    - client_credentials
                  example: client_credentials
                client_id:
                  type: string
                  description: Client ID da aplicação
                  example: 22st50f99o3uan9forfrb6h3uh
                client_secret:
                  type: string
                  description: Client Secret da aplicação
                  example: your-client-secret
      responses:
        "200":
          description: Token gerado com sucesso
          content:
            application/json:
              schema:
                type: object
                required:
                  - access_token
                  - token_type
                  - expires_in
                properties:
                  access_token:
                    type: string
                    description: Bearer token JWT para uso nas chamadas à API
                  token_type:
                    type: string
                    enum:
                      - Bearer
                    example: Bearer
                  expires_in:
                    type: integer
                    description: Tempo de expiração em segundos
                    example: 86400
        "400":
          description: Credenciais inválidas ou parâmetros incorretos
```