Saltar al contenido principal
POST
Create a Funds Recovery Request

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Account-Id
string<uuid>

Account ID (UUID) from X-Account-Id header

Cuerpo

application/json
contactInformation
object
requerido

Contact information of the person reporting the fraud

rootTransactionId
string
requerido

Pix End-to-End transaction ID (32 characters)

Minimum string length: 1
Ejemplo:

"E12345678202411241430ABCDEFGHIJK"

situationType
enum<string>
requerido

Type of fraud situation

Opciones disponibles:
SCAM,
ACCOUNT_TAKEOVER,
COERCION,
FRAUDULENT_ACCESS,
OTHER,
UNKNOWN
Minimum string length: 1
Ejemplo:

"SCAM"

reportDetails
string

Detailed description of the fraud incident (max 2000 characters)

Maximum string length: 2000
Ejemplo:

"Customer reported receiving a call from fake bank employee"

trackingGraphParameters
object

Optional parameters for tracking graph generation

Respuesta

Created

bacenFundsRecoveryId
string
requerido

BACEN/BTG funds recovery external identifier

Ejemplo:

"91d65e98-97c0-4b0f-b577-73625da1f9fc"

createdAt
string<date-time>
requerido

Creation timestamp (ISO 8601 UTC)

Ejemplo:

"2023-11-07T05:31:56Z"

id
string
requerido

Unique identifier for the funds recovery (UUID)

Ejemplo:

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

reporterParticipant
string
requerido

ISPB of the PSP reporting the fraud (8 uppercase alphanumeric characters)

Ejemplo:

"12345678"

rootTransactionId
string
requerido

Pix End-to-End transaction ID (32 characters)

Ejemplo:

"E12345678202411241430ABCDEFGHIJK"

situationType
enum<string>
requerido

Type of fraud situation

Opciones disponibles:
SCAM,
ACCOUNT_TAKEOVER,
COERCION,
FRAUDULENT_ACCESS,
OTHER,
UNKNOWN
Ejemplo:

"SCAM"

status
enum<string>
requerido

Current status of the funds recovery

Opciones disponibles:
CREATED,
TRACKED,
AWAITING_ANALYSIS,
ANALYSED,
REFUNDING,
COMPLETED,
CANCELLED
Ejemplo:

"CREATED"

updatedAt
string<date-time>
requerido

Last update timestamp (ISO 8601 UTC)

Ejemplo:

"2023-11-07T05:31:56Z"

contactInformation
object

Contact information of the person reporting the fraud

reportDetails
string

Detailed description of the fraud incident

Ejemplo:

"Customer reported receiving a call from fake bank employee"

trackingGraph
object

Tracking graph generated during creation (when trackingGraphParameters provided)