Crear marcador de fraude
Persiste localmente un marcador de fraude minimizado tras aplicar hash a las entradas de PII para su almacenamiento, y envía el reporte de marcador de fraude de BACEN correspondiente de forma síncrona tras persistir, con seguimiento mediante report_status (PENDING/SENT/FAILED) + request_id.
Autorizaciones
JWT bearer token issued by the identity provider.
Cuerpo
Fraud marker to persist locally and report to BACEN synchronously-after-persist, tracked by report_status (PENDING/SENT/FAILED) + request_id; PII inputs (key value, owner tax ID) are hashed before storage
Plaintext PIX key value to mark; stored only as an HMAC hash, never in the clear
"usuario@example.com"
Optional plaintext owner tax ID (CPF/CNPJ); stored only as an HMAC hash, never in the clear
"12345678901"
ISPB (8 numeric digits) of the participant raising the fraud marker
"12345678"
Free-text justification for the fraud marker
Respuesta
Created
Persisted minimized fraud marker (PII stored only as hashes)
Record creation timestamp (RFC 3339, UTC)
"2026-06-14T12:00:00Z"
Server-assigned fraud-marker record UUID
"550e8400-e29b-41d4-a716-446655440002"
HMAC hash of the marked PIX key value (hex); the plaintext key is never returned
"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
ISPB (8 numeric digits) of the participant that raised the fraud marker
"12345678"
Free-text justification for the fraud marker
BACEN report delivery state: PENDING, SENT, or FAILED (FAILED is retryable; the local record stands)
"SENT"
Local fraud-marker state: ACTIVE (counts toward fraud stats) or INACTIVE (retained for audit only)
"ACTIVE"
Last update timestamp (RFC 3339, UTC)
"2026-06-14T12:00:00Z"
HMAC hash of the owner tax ID (hex); omitted when no tax ID was supplied
"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"

