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 |