Skip to main content
POST
Criar recuperação de fundos DICT

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Corpo

application/json

DICT MED 2.0 funds-recovery to create locally and report to BACEN (createFundsRecovery)

participantISPB
string
obrigatório

ISPB (8 numeric digits) of the participant reporting the funds recovery; gated to the calling direct's scope

Exemplo:

"12345678"

rootTransactionId
string
obrigatório

BACEN end-to-end identifier (E2E ID) of the originating fraudulent transaction; BACEN dedups a recovery per RootTransactionId

Exemplo:

"E1234567820260614ABCDEFGHIJKLMNO"

situationType
string
obrigatório

MED 2.0 situation classification: SCAM, ACCOUNT_TAKEOVER, COERCION, FRAUDULENT_ACCESS, OTHER, or UNKNOWN

Exemplo:

"SCAM"

Resposta

Created

Persisted local DICT funds-recovery record

createdAt
string
obrigatório

Record creation timestamp (RFC 3339, UTC)

Exemplo:

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

id
string
obrigatório

Server-assigned local funds-recovery record UUID

Exemplo:

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

reportStatus
string
obrigatório

BACEN report delivery state: PENDING, SENT, or FAILED (FAILED is retryable; the local record stands)

Exemplo:

"SENT"

rootTransactionId
string
obrigatório

BACEN end-to-end identifier (E2E ID) of the originating fraudulent transaction

Exemplo:

"E1234567820260614ABCDEFGHIJKLMNO"

situationType
string
obrigatório

MED 2.0 situation classification

Exemplo:

"SCAM"

status
string
obrigatório

Local funds-recovery lifecycle state: CREATED, AWAITING_ANALYSIS, ANALYSED, REFUNDING, COMPLETED, or CANCELLED

Exemplo:

"CREATED"

updatedAt
string
obrigatório

Last update timestamp (RFC 3339, UTC)

Exemplo:

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