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

# Consultar transação

> Consulta os dados de uma transação específica pelo seu identificador único (UUID).



## OpenAPI

````yaml GET /transactions/{id}
openapi: 3.1.0
info:
  title: Pluggou API
  description: API de intermediação de pagamentos da Pluggou
  version: 1.0.0
servers:
  - url: https://api.pluggoutech.com/api
security:
  - publicKey: []
    secretKey: []
paths:
  /transactions/{id}:
    get:
      tags:
        - Transações
      summary: Consultar transação
      description: >-
        Consulta os dados de uma transação específica pelo seu identificador
        único (UUID).
      operationId: getTransaction
      parameters:
        - name: id
          in: path
          required: true
          description: Identificador único da transação (UUID).
          schema:
            type: string
            format: uuid
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
      responses:
        '200':
          description: Transação encontrada com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTransactionSuccess'
              example:
                success: true
                message: Transação encontrada com sucesso.
                data:
                  id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                  payment_method: pix
                  e2e_id: E12345678202301011234abcdefghijkl
                  amount: 10000
                  platform_tax: 149
                  liquid_amount: 9851
                  status: paid
                  paid_at: '2026-01-29 11:30:00'
                  created_at: '2026-01-29 11:25:00'
        '401':
          description: Erro de autenticação
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthErrorResponse'
              examples:
                credenciais_ausentes:
                  summary: Credenciais ausentes
                  value:
                    error: Credenciais inválidas
                    message: Chave pública e chave privada são obrigatórias
                credenciais_invalidas:
                  summary: Credenciais inválidas
                  value:
                    error: Credenciais inválidas
                    message: Chave não encontrada ou inativa
        '403':
          description: Erro de permissão
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                conta_nao_aprovada:
                  summary: Conta não aprovada
                  value:
                    success: false
                    message: >-
                      Sua conta precisa estar aprovada para usar esta
                      funcionalidade.
                    data: null
                conta_bloqueada:
                  summary: Conta bloqueada
                  value:
                    success: false
                    message: Sua conta está bloqueada.
                    data: null
        '404':
          description: Transação não encontrada
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                success: false
                message: Transação não encontrada.
                data: null
components:
  schemas:
    GetTransactionSuccess:
      type: object
      properties:
        success:
          type: boolean
          description: Indica se a operação foi bem-sucedida.
        message:
          type: string
          description: Mensagem descritiva do resultado.
        data:
          type: object
          properties:
            id:
              type: string
              format: uuid
              description: Identificador único da transação (UUID).
            payment_method:
              type: string
              description: 'Método de pagamento utilizado (ex: `pix`).'
            e2e_id:
              type: string
              nullable: true
              description: >-
                Identificador end-to-end do PIX gerado pelo banco. `null` se o
                pagamento ainda não foi confirmado.
            amount:
              type: integer
              description: Valor total da transação em centavos.
            platform_tax:
              type: integer
              description: Valor da taxa da plataforma em centavos.
            liquid_amount:
              type: integer
              description: >-
                Valor líquido creditado na sua conta em centavos (amount -
                platform_tax).
            status:
              type: string
              enum:
                - pending
                - paid
                - failed
                - canceled
                - refunded
                - chargeback
              description: Status atual da transação.
            paid_at:
              type: string
              nullable: true
              description: >-
                Data/hora do pagamento no formato `YYYY-MM-DD HH:mm:ss`. `null`
                se ainda não foi pago.
            created_at:
              type: string
              description: >-
                Data/hora de criação da transação no formato `YYYY-MM-DD
                HH:mm:ss`.
    AuthErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Tipo do erro de autenticação.
        message:
          type: string
          description: Mensagem descritiva do erro.
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Sempre `false` em caso de erro.
        message:
          type: string
          description: Mensagem descritiva do erro.
        data:
          type: object
          nullable: true
          description: Sempre `null` em erros simples.
  securitySchemes:
    publicKey:
      type: apiKey
      in: header
      name: X-Public-Key
      description: 'Sua chave pública de acesso à API. Ex: `pk_live_abc123def456...`'
    secretKey:
      type: apiKey
      in: header
      name: X-Secret-Key
      description: 'Sua chave secreta de acesso à API. Ex: `sk_live_xyz789ghi012...`'

````