Refresh DICT fraud marker from BACEN
Re-reads a locally held fraud marker from BACEN (getFraudMarker) and converges the local copy through the snapshot compare-and-swap, writing an audit event with it. No scheduler runs this — the operator triggers it explicitly. 404 when the marker is not held locally (GET /api/v1/dict/fraud-markers/ is what lands one) or BACEN does not know it; a BACEN failure leaves the local copy untouched.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
Required key used to prevent replaying the mutation.
Parâmetros de caminho
BACEN-assigned fraud-marker resource UUID; a local record UUID never resolves here
Resposta
OK
Persisted minimized fraud marker (PII stored only as hashes)
Record creation timestamp (RFC 3339, UTC)
"2026-06-14T12:00:00Z"
BACEN fraud classification: APPLICATION_FRAUD, MULE_ACCOUNT, SCAMMER_ACCOUNT, OTHER, or UNKNOWN
"MULE_ACCOUNT"
BACEN-assigned fraud-marker resource UUID — the public, canonical identity of this record
"550e8400-e29b-41d4-a716-446655440002"
HMAC hash of the marked Pix key value (hex); empty when no key was given
"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
HMAC hash of the owner tax ID (hex); kept for consumers that index/audit on the minimized projection
"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
ISPB (8 digits or uppercase letters) of the participant that raised the fraud marker
"12345678"
BACEN report delivery state. Always SENT at rest (a resource row is persisted only once BACEN has confirmed it; a rejected or ambiguous attempt creates no row).
"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"
BACEN's own operational envelope for its most recent interaction on this fraud marker, including its LastModified version; omitted when no BACEN interaction has ever landed on it.
When BACEN created this fraud marker (RFC 3339, UTC); distinct from createdAt
"2026-06-14T12:00:00Z"
Clear Pix key value the caller informed or BACEN echoed (ExtendedFraudMarker.Key); omitted when no key is known
"usuario@example.com"
BACEN-assigned infraction that originated this marker (ExtendedFraudMarker.InfractionReport.Id); omitted when there is none
"550e8400-e29b-41d4-a716-446655440005"
Reporter ISPB of the originating infraction (ExtendedFraudMarker.InfractionReport.ReporterParticipant); omitted when there is none
"12345678"
Durable operation-intent id that produced this snapshot's current state, when known
"01930000-0000-7000-8000-000000000000"
BACEN-observed clear owner tax ID (CPF/CNPJ) — ExtendedFraudMarker.TaxIdNumber; omitted when BACEN has never echoed one back
"52998224725"

