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

# Operaciones PIX

> Consulta los campos PIX de disputa y antifraude alineados con BACEN — reclamos de claves, reportes de infracción, reembolsos y marcadores de fraude.

Esta página cubre los campos específicos de resolución de disputas PIX y operaciones antifraude, incluyendo reclamos de claves, reportes de infracción, solicitudes de reembolso y marcadores de fraude. Estos campos siguen los estándares regulatorios de BACEN.

## 1. Reclamos

***

| Field               | Description                                                                | Used in |
| ------------------- | -------------------------------------------------------------------------- | ------- |
| claimId             | Identificador único del reclamo de clave                                   | PIX     |
| claimType           | Tipo de reclamo: OWNERSHIP o PORTABILITY                                   | PIX     |
| claimStatus         | Estado actual: OPEN, WAITING\_RESOLUTION, CONFIRMED, CANCELLED o COMPLETED | PIX     |
| claimer             | Información de la parte reclamante (documento, nombre, tipo)               | PIX     |
| claimerAccount      | Detalles de cuenta de la parte reclamante                                  | PIX     |
| donorParticipant    | ISPB del participante donante (8 dígitos)                                  | PIX     |
| confirmReason       | Razón para confirmar el reclamo                                            | PIX     |
| cancelReason        | Razón para cancelar el reclamo                                             | PIX     |
| cancelledBy         | Parte que canceló el reclamo: DONOR o CLAIMER                              | PIX     |
| resolutionPeriodEnd | Fecha límite para que la contraparte responda (D+7)                        | PIX     |
| completionPeriodEnd | Fecha límite para la finalización del reclamo (D+14)                       | PIX     |

## 2. Reportes de infracción

***

| Field                   | Description                                                          | Used in |
| ----------------------- | -------------------------------------------------------------------- | ------- |
| infractionReportId      | Identificador único del reporte de infracción                        | PIX     |
| transactionId           | Identificador de la transacción SPI (End-to-End ID)                  | PIX     |
| reason                  | Razón de la infracción: REFUND\_REQUEST o REFUND\_CANCELLED          | PIX     |
| situationType           | Tipo de situación de fraude (ej., SCAM, ACCOUNT\_TAKEOVER, COERCION) | PIX     |
| reportDetails           | Descripción detallada de la infracción (máx. 2000 caracteres)        | PIX     |
| reporterParticipant     | ISPB del participante reportador (8 dígitos)                         | PIX     |
| counterpartyParticipant | ISPB de la contraparte (8 dígitos)                                   | PIX     |
| analysisResult          | Resultado del análisis: AGREED o DISAGREED                           | PIX     |
| analysisDetails         | Comentarios detallados del análisis                                  | PIX     |
| status                  | Estado actual: OPEN, ACKNOWLEDGED, CLOSED o CANCELLED                | PIX     |

## 3. Solicitudes de reembolso

***

| Field                 | Description                                                               | Used in |
| --------------------- | ------------------------------------------------------------------------- | ------- |
| refundId              | Identificador único de la solicitud de reembolso                          | PIX     |
| transactionId         | Identificador de la transacción PIX original (End-to-End ID)              | PIX     |
| amount                | Monto del reembolso en BRL                                                | PIX     |
| infractionId          | ID del reporte de infracción relacionado (requerido para razón FRAUD)     | PIX     |
| refundStatus          | Estado actual: OPEN, CLOSED o CANCELLED                                   | PIX     |
| refundAnalysisResult  | Resultado del análisis: TOTALLY\_ACCEPTED, PARTIALLY\_ACCEPTED o REJECTED | PIX     |
| refundAnalysisDetails | Comentarios detallados del análisis                                       | PIX     |
| refundRejectionReason | Razón de rechazo: NO\_BALANCE, ACCOUNT\_CLOSURE, INVALID\_REQUEST u OTHER | PIX     |
| refundTransactionId   | End-to-End ID de la transacción de reembolso                              | PIX     |

## 4. Marcadores de fraude

***

| Field             | Description                                                                | Used in |
| ----------------- | -------------------------------------------------------------------------- | ------- |
| fraudMarkerId     | Identificador único del marcador de fraude                                 | PIX     |
| taxIdNumber       | CPF (11 dígitos) o CNPJ (14 dígitos) del individuo o entidad marcada       | PIX     |
| fraudType         | Clasificación: APPLICATION\_FRAUD, MULE\_ACCOUNT, SCAMMER\_ACCOUNT u OTHER | PIX     |
| key               | Clave PIX opcional asociada al fraude                                      | PIX     |
| document          | CPF o CNPJ de la parte marcada                                             | PIX     |
| fraudMarkerStatus | Estado actual: REGISTERED o CANCELLED                                      | PIX     |