Pular para o conteúdo principal
POST
Refresh DICT fraud marker from BACEN

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency
string
obrigatório

Required key used to prevent replaying the mutation.

Parâmetros de caminho

id
string<uuid>
obrigatório

BACEN-assigned fraud-marker resource UUID; a local record UUID never resolves here

Resposta

OK

Persisted minimized fraud marker (PII stored only as hashes)

createdAt
string
obrigatório

Record creation timestamp (RFC 3339, UTC)

Exemplo:

"2026-06-14T12:00:00Z"

fraudType
string
obrigatório

BACEN fraud classification: APPLICATION_FRAUD, MULE_ACCOUNT, SCAMMER_ACCOUNT, OTHER, or UNKNOWN

Exemplo:

"MULE_ACCOUNT"

id
string
obrigatório

BACEN-assigned fraud-marker resource UUID — the public, canonical identity of this record

Exemplo:

"550e8400-e29b-41d4-a716-446655440002"

keyValueHash
string
obrigatório

HMAC hash of the marked Pix key value (hex); empty when no key was given

Exemplo:

"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"

ownerTaxIdHash
string
obrigatório

HMAC hash of the owner tax ID (hex); kept for consumers that index/audit on the minimized projection

Exemplo:

"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"

participantISPB
string
obrigatório

ISPB (8 digits or uppercase letters) of the participant that raised the fraud marker

Exemplo:

"12345678"

reportStatus
string
obrigatório

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

Exemplo:

"SENT"

status
string
obrigatório

Local fraud-marker state: ACTIVE (counts toward fraud stats) or INACTIVE (retained for audit only)

Exemplo:

"ACTIVE"

updatedAt
string
obrigatório

Last update timestamp (RFC 3339, UTC)

Exemplo:

"2026-06-14T12:00:00Z"

bacen
object

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.

bacenCreationTime
string

When BACEN created this fraud marker (RFC 3339, UTC); distinct from createdAt

Exemplo:

"2026-06-14T12:00:00Z"

keyValue
string

Clear Pix key value the caller informed or BACEN echoed (ExtendedFraudMarker.Key); omitted when no key is known

Exemplo:

"usuario@example.com"

originInfractionReportId
string

BACEN-assigned infraction that originated this marker (ExtendedFraudMarker.InfractionReport.Id); omitted when there is none

Exemplo:

"550e8400-e29b-41d4-a716-446655440005"

originInfractionReporterISPB
string

Reporter ISPB of the originating infraction (ExtendedFraudMarker.InfractionReport.ReporterParticipant); omitted when there is none

Exemplo:

"12345678"

originOperationId
string

Durable operation-intent id that produced this snapshot's current state, when known

Exemplo:

"01930000-0000-7000-8000-000000000000"

ownerTaxId
string

BACEN-observed clear owner tax ID (CPF/CNPJ) — ExtendedFraudMarker.TaxIdNumber; omitted when BACEN has never echoed one back

Exemplo:

"52998224725"