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

# Operações PIX

> Consulte os campos PIX de disputa e antifraude alinhados ao BACEN — reivindicações de chaves, relatórios de infração, reembolsos e marcadores de fraude.

Esta página cobre os campos específicos de resolução de disputas PIX e operações antifraude, incluindo reivindicações de chaves, relatórios de infração, solicitações de reembolso e marcadores de fraude. Esses campos seguem os padrões regulatórios do BACEN.

## 1. Reivindicações

***

| Field               | Description                                                                | Used in |
| ------------------- | -------------------------------------------------------------------------- | ------- |
| claimId             | Identificador único da reivindicação de chave                              | PIX     |
| claimType           | Tipo de reivindicação: OWNERSHIP ou PORTABILITY                            | PIX     |
| claimStatus         | Status atual: OPEN, WAITING\_RESOLUTION, CONFIRMED, CANCELLED ou COMPLETED | PIX     |
| claimer             | Informações da parte reivindicante (documento, nome, tipo)                 | PIX     |
| claimerAccount      | Detalhes da conta da parte reivindicante                                   | PIX     |
| donorParticipant    | ISPB do participante doador (8 dígitos)                                    | PIX     |
| confirmReason       | Motivo para confirmar a reivindicação                                      | PIX     |
| cancelReason        | Motivo para cancelar a reivindicação                                       | PIX     |
| cancelledBy         | Parte que cancelou a reivindicação: DONOR ou CLAIMER                       | PIX     |
| resolutionPeriodEnd | Prazo para a contraparte responder (D+7)                                   | PIX     |
| completionPeriodEnd | Prazo para conclusão da reivindicação (D+14)                               | PIX     |

## 2. Relatórios de infração

***

| Field                   | Description                                                         | Used in |
| ----------------------- | ------------------------------------------------------------------- | ------- |
| infractionReportId      | Identificador único do relatório de infração                        | PIX     |
| transactionId           | Identificador da transação SPI (End-to-End ID)                      | PIX     |
| reason                  | Motivo da infração: REFUND\_REQUEST ou REFUND\_CANCELLED            | PIX     |
| situationType           | Tipo de situação de fraude (ex.: SCAM, ACCOUNT\_TAKEOVER, COERCION) | PIX     |
| reportDetails           | Descrição detalhada da infração (máx. 2000 caracteres)              | PIX     |
| reporterParticipant     | ISPB do participante reportador (8 dígitos)                         | PIX     |
| counterpartyParticipant | ISPB da contraparte (8 dígitos)                                     | PIX     |
| analysisResult          | Resultado da análise: AGREED ou DISAGREED                           | PIX     |
| analysisDetails         | Comentários detalhados da análise                                   | PIX     |
| status                  | Status atual: OPEN, ACKNOWLEDGED, CLOSED ou CANCELLED               | PIX     |

## 3. Solicitações de reembolso

***

| Field                 | Description                                                                  | Used in |
| --------------------- | ---------------------------------------------------------------------------- | ------- |
| refundId              | Identificador único da solicitação de reembolso                              | PIX     |
| transactionId         | Identificador da transação PIX original (End-to-End ID)                      | PIX     |
| amount                | Valor do reembolso em BRL                                                    | PIX     |
| infractionId          | ID do relatório de infração relacionado (obrigatório para motivo FRAUD)      | PIX     |
| refundStatus          | Status atual: OPEN, CLOSED ou CANCELLED                                      | PIX     |
| refundAnalysisResult  | Resultado da análise: TOTALLY\_ACCEPTED, PARTIALLY\_ACCEPTED ou REJECTED     | PIX     |
| refundAnalysisDetails | Comentários detalhados da análise                                            | PIX     |
| refundRejectionReason | Motivo da rejeição: NO\_BALANCE, ACCOUNT\_CLOSURE, INVALID\_REQUEST ou OTHER | PIX     |
| refundTransactionId   | End-to-End ID da transação de reembolso                                      | PIX     |

## 4. Marcadores de fraude

***

| Field             | Description                                                                 | Used in |
| ----------------- | --------------------------------------------------------------------------- | ------- |
| fraudMarkerId     | Identificador único do marcador de fraude                                   | PIX     |
| taxIdNumber       | CPF (11 dígitos) ou CNPJ (14 dígitos) do indivíduo ou entidade sinalizada   | PIX     |
| fraudType         | Classificação: APPLICATION\_FRAUD, MULE\_ACCOUNT, SCAMMER\_ACCOUNT ou OTHER | PIX     |
| key               | Chave PIX opcional associada à fraude                                       | PIX     |
| document          | CPF ou CNPJ da parte sinalizada                                             | PIX     |
| fraudMarkerStatus | Status atual: REGISTERED ou CANCELLED                                       | PIX     |