> ## 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 | 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 |
| 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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.