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

# Realizar Login

> Autentica o usuário com email e senha e retorna um Bearer Token para uso nas demais rotas. O token tem prazo de expiração informado na resposta.


<Note>
  Rota pública — não requer autenticação. Retorna um Bearer Token JWT para uso nas demais rotas.
</Note>


## OpenAPI

````yaml POST /v1/login
openapi: 3.1.0
info:
  title: 4Selet Pay API
  description: >
    API de processamento de pagamentos da plataforma 4Selet Pay. Suporta
    cobranças únicas, assinaturas recorrentes, PIX, Cartão de Crédito. Todas as
    rotas autenticadas requerem um Bearer Token obtido via `/v1/login`.
  version: 1.0.0
  contact:
    name: 4Selet Pay
    email: suporte@4selet.com.br
servers:
  - url: https://sandbox.4seletpay.com.br/api
    description: Servidor de Sandbox
security:
  - bearerAuth: []
tags:
  - name: Autenticação
    description: Rotas de autenticação e criação de usuários
  - name: Cobranças
    description: Criação, consulta, cancelamento e reembolso de cobranças
  - name: Pedidos
    description: Consulta de pedidos e gerenciamento de confirmações desafiadas
  - name: Assinaturas
    description: Criação e gerenciamento de assinaturas recorrentes
  - name: Faturas
    description: Gerenciamento de faturas e pagamento de faturas em atraso
  - name: Clientes Bloqueados
    description: Gerenciamento de lista negra de clientes
  - name: Contas
    description: Criação e gerenciamento de contas na plataforma
  - name: Aplicativo
    description: Endpoints para dashboard e uso via aplicativo mobile
  - name: Notificações Push
    description: Envio e gerenciamento de notificações push
  - name: Utilitários
    description: Endpoints utilitários como listagem de fusos horários
  - name: Gestão
    description: Relatórios gerenciais (acesso restrito a Super Admins)
  - name: Webhooks
    description: Endpoints para receber notificações de gateways de pagamento
  - name: Endpoints de Webhook
    description: >-
      Gerenciamento de endpoints de webhook para receber notificações de eventos
      da plataforma
  - name: Links de Pagamento
    description: Criação e gerenciamento de links de pagamento com checkout pré-configurado
paths:
  /v1/login:
    post:
      tags:
        - Autenticação
      summary: Realizar login
      description: >
        Autentica o usuário com email e senha e retorna um Bearer Token para uso
        nas demais rotas. O token tem prazo de expiração informado na resposta.
      operationId: login
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LoginRequest'
            example:
              email: usuario@exemplo.com.br
              password: suaSenha123
      responses:
        '200':
          description: Login realizado com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LoginResponse'
              example:
                access_token: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...
                token_type: Bearer
                expires_at: '2026-04-11T12:00:00.000000Z'
        '401':
          description: Credenciais inválidas
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                success: false
                message: Invalid Credentials
        '422':
          $ref: '#/components/responses/ValidationError'
      security: []
components:
  schemas:
    LoginRequest:
      type: object
      required:
        - email
        - password
      properties:
        email:
          type: string
          format: email
          description: E-mail do usuário (obrigatório)
          example: usuario@exemplo.com.br
        password:
          type: string
          format: password
          description: Senha do usuário (obrigatório)
          example: suaSenha123
    LoginResponse:
      type: object
      properties:
        access_token:
          type: string
          description: Token de acesso Bearer JWT
          example: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...
        token_type:
          type: string
          description: Tipo do token
          example: Bearer
        expires_at:
          type: string
          format: date-time
          description: Data/hora de expiração do token
          example: '2026-04-11T12:00:00.000000Z'
    ErrorResponse:
      type: object
      properties:
        mensagem:
          type: string
          example: Um erro inesperado acabou de acontecer.
        erro:
          type: boolean
          example: true
        mensagenserro:
          type: array
          items:
            type: string
          example:
            - Detalhe do erro ocorrido.
        codigoretorno:
          type: integer
          example: 400
        id:
          type: string
          example: 00000000-0000-0000-0000-000000000000
        data:
          type: array
          example: []
    ValidationErrorResponse:
      type: object
      properties:
        message:
          type: string
          example: The given data was invalid.
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          example:
            client.email:
              - O campo client.email é obrigatório.
            payment.type:
              - O campo payment.type é obrigatório.
  responses:
    ValidationError:
      description: Erro de validação dos dados enviados
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ValidationErrorResponse'
          example:
            message: The given data was invalid.
            errors:
              client.email:
                - O campo client.email é obrigatório.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Token JWT obtido via `POST /v1/login`. Envie no header `Authorization:
        Bearer <token>`.

````