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

# Consultar transação por chave PIX e identificador

> **Requer token Bearer no header Authorization**.

Retorna uma transação específica associada a uma chave PIX, buscando pelo identificador fornecido.

**Lógica de resolução do identificador**:
O valor informado é comparado simultaneamente contra `endToEndId` (e2eId do PIX), `externalId` e `id` numérico. Na prática não há ambiguidade: o formato de cada tipo é único (e2eId começa com `E` + 32 chars alfanuméricos; id é puramente numérico; externalId é qualquer outra string).



## OpenAPI

````yaml get /api/pix/transactions/pix-key/{pixKey}/{identifier}
openapi: 3.0.0
info:
  title: Fire Banking Public API
  description: >-
    API Pública da Plataforma Fire Banking para integração com serviços de
    pagamento PIX e gestão de contas
  version: 0.1.0
  contact: {}
servers:
  - url: https://api.public.firebanking.com.br
    description: Servidor de produção
security: []
tags:
  - name: auth
    description: Endpoints de autenticação
  - name: Balance
    description: Endpoints de consulta de saldo
  - name: PIX
    description: Endpoints de transações PIX
  - name: Webhooks
    description: Endpoints de gerenciamento de webhooks
paths:
  /api/pix/transactions/pix-key/{pixKey}/{identifier}:
    get:
      tags:
        - PIX
      summary: Consultar transação por chave PIX e identificador
      description: >-
        **Requer token Bearer no header Authorization**.


        Retorna uma transação específica associada a uma chave PIX, buscando
        pelo identificador fornecido.


        **Lógica de resolução do identificador**:

        O valor informado é comparado simultaneamente contra `endToEndId` (e2eId
        do PIX), `externalId` e `id` numérico. Na prática não há ambiguidade: o
        formato de cada tipo é único (e2eId começa com `E` + 32 chars
        alfanuméricos; id é puramente numérico; externalId é qualquer outra
        string).
      operationId: PixController_getTransactionByPixKeyAndIdentifier
      parameters:
        - name: pixKey
          required: true
          in: path
          description: Chave PIX (CPF, CNPJ, telefone, e-mail ou chave aleatória EVP)
          schema:
            type: string
            example: joao@example.com
        - name: identifier
          required: true
          in: path
          description: >-
            Identificador da transação: comparado contra endToEndId (e2eId),
            externalId ou id numérico simultaneamente
          schema:
            type: string
            example: E00416968202512121343VX5Sx8fIpkY
      responses:
        '200':
          description: Transação encontrada com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionSearchOutputDto'
        '401':
          description: Token não fornecido ou inválido
        '404':
          description: Transação não encontrada para a chave PIX e identificador informados
      security:
        - bearer: []
components:
  schemas:
    TransactionSearchOutputDto:
      type: object
      required:
        - transactionId
        - externalId
        - status
        - operationType
        - movementType
        - originalAmount
        - feeAmount
        - finalAmount
        - endToEndId
        - createdAt
        - counterpart
      properties:
        transactionId:
          type: string
          description: ID único da transação
          example: '12345'
        externalId:
          type: string
          description: ID externo da transação
          example: ext-123456
        status:
          type: string
          description: Status da transação (em português)
          enum:
            - Confirmado
            - Pendente
            - Error
          example: Confirmado
        operationType:
          type: string
          description: Tipo de operação (em português)
          enum:
            - Pix in
            - Pix out
            - Refund in
            - Refund out
          example: Pix in
        movementType:
          type: string
          description: Tipo de movimento (DEBIT para saída, CREDIT para entrada)
          enum:
            - DEBIT
            - CREDIT
          example: CREDIT
        originalAmount:
          type: number
          description: Valor original em reais
          example: 100
        feeAmount:
          type: number
          description: Valor da taxa em reais
          example: 1
        finalAmount:
          type: number
          description: Valor final em reais (original ± taxa)
          example: 99
        endToEndId:
          type: string
          description: End-to-End ID do PIX
          example: E12345678901234567890123456789012
        createdAt:
          type: string
          description: Data de criação (ISO 8601)
          example: '2025-01-15T10:30:00.000Z'
        processedAt:
          type: string
          nullable: true
          description: Data de processamento (ISO 8601)
          example: '2025-01-15T10:30:05.000Z'
        counterpart:
          $ref: '#/components/schemas/CounterpartOutputDto'
          description: Dados da contraparte
    CounterpartOutputDto:
      type: object
      required:
        - name
        - document
        - bank
      properties:
        name:
          type: string
          description: Nome da contraparte
          example: João Silva
        document:
          type: string
          description: 'Documento mascarado (CPF: ***.XXX.XXX-**, CNPJ: **.XXX.XXX/****-**)'
          example: '***.456.789-**'
        bank:
          $ref: '#/components/schemas/CounterpartBankOutputDto'
          description: Dados bancários da contraparte
    CounterpartBankOutputDto:
      type: object
      properties:
        bankISPB:
          type: string
          nullable: true
          description: Código ISPB do banco
          example: '00000000'
        bankName:
          type: string
          nullable: true
          description: Nome do banco
          example: Banco do Brasil
        bankCode:
          type: string
          nullable: true
          description: Código do banco (COMPE)
          example: '001'
        accountBranch:
          type: string
          nullable: true
          description: Agência da conta
          example: '0001'
        accountNumber:
          type: string
          nullable: true
          description: Número da conta
          example: 123456-7
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Enter JWT token

````