CreateFundsRecoveryRequest

Request body to create a new FundsRecovery record (Recuperação de Valores MED 2.0). Bacen-conformant per OpenAPI v2.10.1 FundsRecovery.required.

  • contactInformation
    Type: object · ContactInfo
    required

    Contact information for the fraud reporting team

    • email
      Type: string
      max length:  
      255
      required

      Email address of the fraud reporting team (Bacen DICT format — lowercase only)

    • phone
      Type: string
      max length:  
      64
      required

      Phone number of the fraud reporting team (E.164, e.g. +5511999990000)

  • situationType
    Type: string enum
    required

    Type of fraud/dispute situation (per Bacen DICT API v2.10.1 SituationType schema — shared across InfractionReport and FundsRecovery)

    values
    • SCAM
    • ACCOUNT_TAKEOVER
    • COERCION
    • FRAUDULENT_ACCESS
    • OTHER
    • UNKNOWN
  • transactionId
    Type: string
    min length:  
    1
    required

    End-to-end ID of the original PIX transaction subject to funds recovery (Bacen EndToEndId, alphanumeric, 8–32 chars)

  • reportDetails
    Type: string
    max length:  
    2000

    Free-text details about the fraud situation (max 2000 chars; required when situationType=OTHER)

  • trackingParameters
    Type: object | null · TrackingGraphParameters

    Tracking graph parameters used for forensic analysis; null when not provided

    • hopWindow
      Type: string Format: duration

      Time window around each transaction that DICT considers when linking graph edges. ISO-8601 duration. Optional (Bacen default and ceiling: PT2H, per API DICT 2.12.1).

    • maxHops
      Type: integer Format: int32
      min:  
      1
      max:  
      2

      Maximum number of hops (graph depth) that DICT will traverse from the originating transaction. Limits depth of the fraud network analysis. Optional (Bacen default and ceiling: 2, per API DICT 2.12.1).

    • maxTransactions
      Type: integer Format: int32
      min:  
      1
      max:  
      5

      Maximum number of outgoing transactions per account node that DICT will follow. Caps graph traversal breadth to prevent analysis explosion on high-volume accounts. Optional (Bacen default and ceiling: 5, per API DICT 2.12.1).

    • minTransactionAmount
      Type: number
      min:  
      0.01

      Minimum transaction amount (BRL) to include in the forensic graph traversal. Transactions below this value are excluded from the fraud network graph. Optional — Bacen applies its own floor when absent (default: 200.00).