UpdateFundsRecoveryRequest

Partial update payload for a FundsRecovery record. All fields are optional. Only advisory fields (situationType, contactInformation, reportDetails) may be changed via PATCH. State transitions happen exclusively via POST /{id}/cancel or POST /{id}/refund. Null fields are ignored (merge semantics, no explicit-clear in V1).

  • contactInformation
    Type: object · ContactInfo

    Contact information for the fraud reporting team

    • email
      Type: string
      max length:  
      255

      Email address of the fraud reporting team

    • phone
      Type: string
      max length:  
      64

      Phone number of the fraud reporting team (E.164 format recommended)

  • reportDetails
    Type: string
    max length:  
    2000

    Updated free-text details about the fraud situation (max 2000 chars; omit to leave unchanged)

  • situationType
    Type: string enum

    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