Create funds recovery [beta]

Creates and establishes a new funds recovery to track and block diverted funds in Pix fraud cases.

The tracking follows the chain of subsequent transactions starting from the contested transaction.

DICT manages the entire process. You define the initial tracking_graph_parameters and DICT executes tracking, prioritization, and blocking, then opens the infraction notifications that the receiving PSPs analyze.

Notes:

  • The contested transaction must have occurred less than 80 days ago. This limit is the same for an original transaction and for a reversal transaction.
  • Only the payer of the contested transaction can create funds recovery. When contesting a reversal, the payer is the participant that sent the reversal — that is, the PSP of the party who received the original transaction.
  • root_transaction_id takes the end-to-end ID of the original transaction, or the reversal end-to-end ID when contesting a reversal.
  • A reversal issued to settle an operational flaw cannot be contested. If the refund behind the reversal had refund_reason of OPERATIONAL_FLAW, DICT rejects the funds recovery as ineligible. This is the only restriction on contesting a reversal.
  • When contesting a reversal, situation_type must be OTHER, which makes report_details mandatory.
  • Recipient PSPs have 7 calendar days to analyze infraction notifications
  • Refund must be initiated within 72 hours after analysis completion
  • Once refunding starts, the process cannot be cancelled

Terminology: the DICT operating manual refers to an original transaction as pacs.008 and to a reversal transaction as pacs.004.

Thie endpoint generates a Pix funds recovery status changed event.

For more information refer to Pix funds recovery.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

CheckRequest Body

Create funds recovery request

string
required
length between 32 and 32

Identifier of the contested transaction, 32 characters.

  • Contesting an original transaction — its end-to-end ID, which begins with E.
  • Contesting a reversal transaction — its reversal end-to-end ID, which begins with D.
string
enum
required

Situation type:

  • SCAM - Scam/fraud through social engineering
  • ACCOUNT_TAKEOVER - Unauthorized transaction without digital authentication
  • COERCION - Coercion crime (kidnapping, extortion)
  • FRAUDULENT_ACCESS - Fraudulent access and authorization (phishing, stolen password) |
  • OTHER - Other cases. This option REQUIRES you pass report_details.
  • UNKNOWN - Unknown state

When the contested transaction is a reversal, the DICT operating manual requires situation_type to be OTHER, which in turn makes report_details mandatory.

Allowed:
contact_information
object
required
string
length ≤ 500

Details about report

tracking_graph_parameters
object

Graph parameters.

Higher values for min_transaction_amount and lower values for max_transactions,max_hops, and hop_window generate smaller and faster graphs. The opposite generates larger and more complete graphs.

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json