> ## 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 de disputa e antifraude do Pix alinhados ao BACEN: reivindicações de chave, relatos de infração, solicitações de devolução e marcadores de fraude.

Esta página cobre os campos específicos da resolução de disputas do Pix e das operações antifraude, incluindo reivindicações de chave, relatos de infração, solicitações de devolução e marcadores de fraude. Esses campos seguem os padrões regulatórios do BACEN.

## 1. Reivindicações

***

| Campo               | Descrição                                                                                                                                                                                                               | Usado em |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| claimId             | Identificador único da reivindicação de chave                                                                                                                                                                           | Pix      |
| claimType           | Tipo de reivindicação: OWNERSHIP ou PORTABILITY                                                                                                                                                                         | Pix      |
| status              | Status atual da reivindicação: OPEN, WAITING\_RESOLUTION, CONFIRMED, CANCELLED ou COMPLETED                                                                                                                             | Pix      |
| claimer             | A parte reivindicante como objeto. `participant` é obrigatório. `document`, `name`, `personType`, `tradeName` e `account` são opcionais. Quando presente, `account` carrega `branch`, `number`, `type` e `openingDate`. | Pix      |
| donorParticipant    | ISPB do participante doador (8 dígitos)                                                                                                                                                                                 | Pix      |
| confirmReason       | Motivo da confirmação da reivindicação                                                                                                                                                                                  | Pix      |
| cancelReason        | Motivo do cancelamento da 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. Relatos de infração

***

| Campo                   | Descrição                                                                   | Usado em |
| ----------------------- | --------------------------------------------------------------------------- | -------- |
| infractionReportId      | Identificador único do relato 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 (por exemplo, SCAM, ACCOUNT\_TAKEOVER, COERCION) | Pix      |
| reportDetails           | Descrição detalhada da infração (máximo de 2000 caracteres)                 | Pix      |
| reporterParticipant     | ISPB do participante relator (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 devolução

***

| Campo                 | Descrição                                                                                                           | Usado em |
| --------------------- | ------------------------------------------------------------------------------------------------------------------- | -------- |
| refundId              | Identificador único da solicitação de devolução                                                                     | Pix      |
| transactionId         | Identificador da transação Pix original (End-to-End ID)                                                             | Pix      |
| amount                | Valor da devolução em BRL                                                                                           | Pix      |
| infractionId          | Opcional. Identificador do relato de infração relacionado                                                           | Pix      |
| status                | Status atual da devolução: 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, OTHER ou PARTICIPANT\_EXCLUSION em uma leitura | Pix      |
| refundTransactionId   | End-to-End ID da transação de devolução                                                                             | Pix      |

## 4. Marcadores de fraude

***

| Campo         | Descrição                                                                                           | Usado em |
| ------------- | --------------------------------------------------------------------------------------------------- | -------- |
| fraudMarkerId | Identificador único do marcador de fraude                                                           | Pix      |
| taxIdNumber   | CPF (11 dígitos) ou CNPJ (14 dígitos) da pessoa ou entidade sinalizada                              | Pix      |
| fraudType     | Classificação: APPLICATION\_FRAUD, MULE\_ACCOUNT, SCAMMER\_ACCOUNT, OTHER ou UNKNOWN em uma leitura | Pix      |
| key           | Chave Pix opcional associada à fraude                                                               | Pix      |
| document      | CPF ou CNPJ da parte sinalizada                                                                     | Pix      |
| status        | Status atual do marcador de fraude: REGISTERED ou CANCELLED                                         | Pix      |