APIX 002

Os participantes do Pix devem entregar dados transacionais detalhados ao BACEN sempre que o regulador solicitar. O Reporter ajuda você a manter esses dados estruturados e prontos para extração ad-hoc. Este guia cobre o relatório APIX 002 (Documento 1202) — o que armazenar, como organizar e como responder quando o BACEN envia uma solicitação.

Diferente do APIX 001, o APIX 002 não tem formato XML fixo nem schema XSD. Cada solicitação define seu próprio formato, dimensões e prazo. A instituição permanece responsável por extrair dados precisos e cumprir o prazo definido pelo regulador.

O que é o APIX 002?

O APIX 002 é um envio regulatório sob demanda ao Banco Central do Brasil, definido pela Instrução Normativa BCB nº 32/2020. Diferente do APIX 001 mensal, é enviado apenas quando o BACEN o solicita explicitamente, com o formato especificado por solicitação.

APIX 001 vs APIX 002

Aspecto	APIX 001	APIX 002
Frequência	Mensal (obrigatório)	Sob demanda
Prazo	15º dia útil do mês seguinte	Definido por solicitação
Formato	XML (XSD fixo)	Definido por solicitação
Layout / XSD	Disponível (versão 2.5)	Não aplicável
Validação	Pré + pós envio	Apenas pós-envio
Código do documento	1201	1202

Quem deve reportar

Tipo de participante	Deve reportar?
Participante direto (provedor de conta transacional)	Sim
Liquidante especial	Sim
Participante indireto (liquidado via BTG, Itaú ou outros)	Não — consolidado pelo participante direto

Os participantes indiretos não reportam o APIX 002 diretamente. O participante direto consolida os dados em seu nome. No entanto, os participantes indiretos ainda devem manter os dados subjacentes disponíveis para que o participante direto os agregue quando o BACEN fizer uma solicitação.

Atributos do envio

Campo	Valor
Nome do documento	Dados do participante de Pix sob demanda
Código do documento	1202
Código STA	APIX002
Frequência	Não periódica (sob demanda)
Formato	Definido por solicitação
Validação	Pós-envio
Transação Autran	SPIXP001
Janela de referência	Dados mensais cobrindo até 12 meses anteriores à solicitação

Por que o APIX 002 não tem formato fixo

A normativa define explicitamente o formato do envio como “a definir por demanda” (“Formato para Remessa: a definir para cada demanda”). Isso tem quatro implicações diretas:

Nenhum XSD padrão é publicado para o APIX 002 — você não pode pré-construir um único template.
O BACEN define o formato no momento da solicitação, incluindo dimensões, granularidade e estrutura do arquivo.
A instituição extrai os dados que correspondem às dimensões especificadas.
O prazo é definido por solicitação, sem tempo de resposta padrão.

Para se manter pronto, seu repositório de dados precisa suportar consultas flexíveis em todas as dimensões que o BACEN possa solicitar.

Dimensões de dados a armazenar

Os participantes devem manter os dados descritos no Anexo II da IN 32/2020 por pelo menos 12 meses. Os dados são organizados em três grupos: transações liquidadas internamente, todas as transações (internas e interbancárias) e combinações cruzadas de dimensões.

Transações liquidadas internamente

Essas dimensões aplicam-se a transações em que tanto pagador quanto recebedor pertencem à mesma instituição.

Campo	Descrição	Valores
Agendada	Se a transação foi agendada	Sim / Não
Suspeita de fraude	Transações analisadas além do limite de tempo de detecção de fraude	Sim / Não
Não liquidada a tempo	Transações que excederam 40 segundos	Sim / Não
Rejeitada	Se a transação foi rejeitada	Sim / Não
Motivo da rejeição	Conforme arts. 38 e 39 da Resolução BCB nº 1/2020	Códigos específicos
Procedimento de iniciação	Como a transação foi iniciada	1) Manual; 2) Valores pré-armazenados
Mecanismo de iniciação	Mecanismo usado para iniciar a transação	1) Chave Pix; 2) QR dinâmico; 3) QR estático; 4) Iniciador de pagamento
Natureza do pagador	Tipo de pessoa	1) Pessoa natural; 2) Pessoa jurídica
Natureza do recebedor	Tipo de pessoa	1) Pessoa natural; 2) Pessoa jurídica
Iniciador	ISPB do iniciador de pagamento	Código ISPB (8 dígitos)

Todas as transações (internas e interbancárias)

Essas dimensões aplicam-se ao conjunto completo de transações, incluindo liquidações interbancárias via SPI.

Campo	Descrição	Exemplo
Ano	Ano de referência	2026
Período	Mês de referência	01–12
Contagem de transações	Contagem total	1.250.000
Valor financeiro	Soma dos valores	R$ 985.000.000,00
Canal de iniciação	Onde a transação começou	1) App; 2) Internet banking; 3) Call center; 4) ATM; 5) Agência

Consultas cruzadas de dimensões

O BACEN pode solicitar combinações de múltiplas dimensões. Exemplos:

Contagem de transações que são agendadas E com suspeita de fraude
Valor de transações rejeitadas por motivo específico E pessoa jurídica
Transações por canal de iniciação E mecanismo de iniciação

Estruture seu armazenamento para que qualquer combinação dessas dimensões possa ser agregada de forma eficiente. Uma tabela ampla e desnormalizada ou um armazenamento colunar funciona melhor do que modelos altamente normalizados para esse tipo de consulta regulatória.

Processo de envio

Sistema e transação

Item	Valor
Sistema	STA (Sistema de Transferência de Arquivos)
Código do arquivo	APIX002
Transação Autran	SPIXP001
Número do documento	1202

Fluxo de seis passos

Aguarde a solicitação do BACEN — não há envio proativo.
Revise o formato e o prazo especificados pelo regulador.
Extraia os dados que correspondem às dimensões solicitadas.
Gere o arquivo no formato especificado.
Envie pelo STA usando o código de arquivo APIX002.
O BACEN executa validação pós-envio sobre os dados recebidos.

Não há validação pré-envio para o APIX 002. O BACEN valida os dados apenas após o envio. Garanta que sua extração esteja precisa antes de enviar.

Recomendações de implementação

Modelo de dados

Uma tabela plana e rica em dimensões facilita a extração sob demanda. O schema mínimo recomendado:

CREATE TABLE pix_transactions (
  id                    UUID PRIMARY KEY,
  occurred_at           TIMESTAMP NOT NULL,
  year                  SMALLINT NOT NULL,
  month                 SMALLINT NOT NULL,
  amount                NUMERIC(18, 2) NOT NULL,
  settlement_type       VARCHAR(16) NOT NULL,        -- INTERNAL / SPI
  scheduled             BOOLEAN NOT NULL DEFAULT FALSE,
  suspected_fraud       BOOLEAN NOT NULL DEFAULT FALSE,
  not_settled_in_time   BOOLEAN NOT NULL DEFAULT FALSE,
  rejected              BOOLEAN NOT NULL DEFAULT FALSE,
  rejection_reason      VARCHAR(8),
  initiation_procedure  SMALLINT NOT NULL,           -- 1=Manual, 2=Pre-stored
  initiation_mechanism  SMALLINT NOT NULL,           -- 1=Key, 2=Dynamic QR, 3=Static QR, 4=Initiator
  payer_nature          SMALLINT NOT NULL,           -- 1=Natural, 2=Legal
  receiver_nature       SMALLINT NOT NULL,           -- 1=Natural, 2=Legal
  initiation_channel    SMALLINT NOT NULL,           -- 1=App, 2=Web, 3=Call, 4=ATM, 5=Branch
  initiator_ispb        VARCHAR(8),
  created_at            TIMESTAMP NOT NULL DEFAULT NOW()
);

A coluna settlement_type distingue as transações liquidadas internamente (ambas as partes na mesma instituição) das transações interbancárias liquidadas via SPI. Essa distinção importa porque algumas dimensões aplicam-se apenas a liquidações internas.

Capacidades necessárias

Armazenar dados transacionais por pelo menos 12 meses antes de qualquer solicitação
Consultar por qualquer dimensão única ou combinação de dimensões
Agregar contagem e valor financeiro em períodos arbitrários
Exportar para múltiplos formatos (CSV, XML, JSON), pois o BACEN pode especificar qualquer um
Gerar relatórios cruzados de dimensões com eficiência

Referências regulatórias

Normativas

Documento	Descrição
IN BCB nº 32/2020	Normativa principal que estabelece o APIX 001 e o APIX 002
IN BCB nº 174/2021	Atualizações dos Anexos I e III da IN 32
IN BCB nº 126/2021	Atualizações anteriores à IN 32
IN BCB nº 383/2023	Atualizações vigentes a partir de 2024-02-01
Resolução BCB nº 1/2020	Regulamentação do Pix (arts. 38, 39 e 99)

Documentos de apoio

Documento	Descrição
Instruções do APIX 002 (PDF)	Orientação para preparar e enviar solicitações sob demanda
Manual de Tempos do Pix	Referência para os limites de tempo do Pix
Portal de envio do BACEN	Instruções e XSD para o APIX 001
Sistema STA	Acesso ao Sistema de Transferência de Arquivos
Instruções do STA	Como usar o sistema
Sisbacen / Autran	Consulta de transações

Contatos do BACEN

Tópico	Email
Entrega do envio	suporte.ti@bcb.gov.br
Conteúdo do documento	estatisticas.spb@bcb.gov.br

Esta página é baseada na regulamentação em vigor em janeiro de 2026. Verifique sempre as publicações mais recentes do BACEN para os requisitos atuais.

Diferente do APIX 001, que pode ser totalmente automatizado com um template do Reporter, o APIX 002 exige intervenção manual — você deve aguardar a solicitação específica do BACEN, entender o formato definido e construir a extração de acordo. O Reporter pode ajudar a gerar o arquivo de saída, mas o template deve ser criado por solicitação.

Visão geral

Conceitos

Guias

Integração

Console

Operações

O que é o APIX 002?

APIX 001 vs APIX 002

Quem deve reportar

Atributos do envio

Por que o APIX 002 não tem formato fixo

Dimensões de dados a armazenar

Transações liquidadas internamente

Todas as transações (internas e interbancárias)

Consultas cruzadas de dimensões

Processo de envio

Sistema e transação

Fluxo de seis passos

Recomendações de implementação

Modelo de dados

Capacidades necessárias

Referências regulatórias

Normativas

Documentos de apoio

Contatos do BACEN

​O que é o APIX 002?

​APIX 001 vs APIX 002

​Quem deve reportar

​Atributos do envio

​Por que o APIX 002 não tem formato fixo

​Dimensões de dados a armazenar

​Transações liquidadas internamente

​Todas as transações (internas e interbancárias)

​Consultas cruzadas de dimensões

​Processo de envio

​Sistema e transação

​Fluxo de seis passos

​Recomendações de implementação

​Modelo de dados

​Capacidades necessárias

​Referências regulatórias

​Normativas

​Documentos de apoio

​Contatos do BACEN

O que é o APIX 002?

APIX 001 vs APIX 002

Quem deve reportar

Atributos do envio

Por que o APIX 002 não tem formato fixo

Dimensões de dados a armazenar

Transações liquidadas internamente

Todas as transações (internas e interbancárias)

Consultas cruzadas de dimensões

Processo de envio

Sistema e transação

Fluxo de seis passos

Recomendações de implementação

Modelo de dados

Capacidades necessárias

Referências regulatórias

Normativas

Documentos de apoio

Contatos do BACEN