1. Claims
| Field | Description | Used in |
|---|---|---|
| claimId | Unique identifier for the key claim | Pix |
| claimType | Type of claim: OWNERSHIP or PORTABILITY | Pix |
| claimStatus | Current status: OPEN, WAITING_RESOLUTION, CONFIRMED, CANCELLED, or COMPLETED | Pix |
| claimer | Information about the claiming party (document, name, type) | Pix |
| claimerAccount | Account details of the claiming party | Pix |
| donorParticipant | ISPB of the donor participant (8 digits) | Pix |
| confirmReason | Reason for confirming the claim | Pix |
| cancelReason | Reason for cancelling the claim | Pix |
| cancelledBy | Party that cancelled the claim: DONOR or CLAIMER | Pix |
| resolutionPeriodEnd | Deadline for the counterparty to respond (D+7) | Pix |
| completionPeriodEnd | Deadline for claim completion (D+14) | Pix |
2. Infraction reports
| Field | Description | Used in |
|---|---|---|
| infractionReportId | Unique identifier for the infraction report | Pix |
| transactionId | SPI transaction identifier (End-to-End ID) | Pix |
| reason | Infraction reason: REFUND_REQUEST or REFUND_CANCELLED | Pix |
| situationType | Type of fraud situation (e.g., SCAM, ACCOUNT_TAKEOVER, COERCION) | Pix |
| reportDetails | Detailed description of the infraction (max 2000 characters) | Pix |
| reporterParticipant | ISPB of the reporting participant (8 digits) | Pix |
| counterpartyParticipant | ISPB of the counterparty (8 digits) | Pix |
| analysisResult | Analysis result: AGREED or DISAGREED | Pix |
| analysisDetails | Detailed analysis comments | Pix |
| status | Current status: OPEN, ACKNOWLEDGED, CLOSED, or CANCELLED | Pix |
3. Refund requests
| Field | Description | Used in |
|---|---|---|
| refundId | Unique identifier for the refund request | Pix |
| transactionId | Original Pix transaction identifier (End-to-End ID) | Pix |
| amount | Refund amount in BRL | Pix |
| infractionId | Related infraction report ID (required for FRAUD reason) | Pix |
| refundStatus | Current status: OPEN, CLOSED, or CANCELLED | Pix |
| refundAnalysisResult | Analysis result: TOTALLY_ACCEPTED, PARTIALLY_ACCEPTED, or REJECTED | Pix |
| refundAnalysisDetails | Detailed analysis comments | Pix |
| refundRejectionReason | Rejection reason: NO_BALANCE, ACCOUNT_CLOSURE, INVALID_REQUEST, or OTHER | Pix |
| refundTransactionId | End-to-End ID of the refund transaction | Pix |
4. Fraud markers
| Field | Description | Used in |
|---|---|---|
| fraudMarkerId | Unique identifier for the fraud marker | Pix |
| taxIdNumber | CPF (11 digits) or CNPJ (14 digits) of the flagged individual or entity | Pix |
| fraudType | Classification: APPLICATION_FRAUD, MULE_ACCOUNT, SCAMMER_ACCOUNT, or OTHER | Pix |
| key | Optional Pix key associated with the fraud | Pix |
| document | CPF or CNPJ of the flagged party | Pix |
| fraudMarkerStatus | Current status: REGISTERED or CANCELLED | Pix |