Create a Funds Recovery Request
Use this endpoint to create a new funds recovery request for a Pix transaction suspected of fraud.
Notes:
- The rootTransactionId must be a valid 32-character Pix End-to-End ID
- situationType indicates the type of fraud situation (SCAM, ACCOUNT_TAKEOVER, COERCION, FRAUDULENT_ACCESS, OTHER, UNKNOWN)
- Contact information (email and phone) is required for communication during the recovery process
Authorizations
JWT bearer token issued by the identity provider.
Headers
Account ID (UUID) from X-Account-Id header
Body
Contact information of the person reporting the fraud
Pix End-to-End transaction ID (32 characters)
1"E12345678202411241430ABCDEFGHIJK"
Type of fraud situation
SCAM, ACCOUNT_TAKEOVER, COERCION, FRAUDULENT_ACCESS, OTHER, UNKNOWN 1"SCAM"
Detailed description of the fraud incident (max 2000 characters)
2000"Customer reported receiving a call from fake bank employee"
Optional parameters for tracking graph generation
Response
Created
BACEN/BTG funds recovery external identifier
"91d65e98-97c0-4b0f-b577-73625da1f9fc"
Creation timestamp (ISO 8601 UTC)
"2023-11-07T05:31:56Z"
Unique identifier for the funds recovery (UUID)
"550e8400-e29b-41d4-a716-446655440000"
ISPB of the PSP reporting the fraud (8 uppercase alphanumeric characters)
"12345678"
Pix End-to-End transaction ID (32 characters)
"E12345678202411241430ABCDEFGHIJK"
Type of fraud situation
SCAM, ACCOUNT_TAKEOVER, COERCION, FRAUDULENT_ACCESS, OTHER, UNKNOWN "SCAM"
Current status of the funds recovery
CREATED, TRACKED, AWAITING_ANALYSIS, ANALYSED, REFUNDING, COMPLETED, CANCELLED "CREATED"
Last update timestamp (ISO 8601 UTC)
"2023-11-07T05:31:56Z"
Contact information of the person reporting the fraud
Detailed description of the fraud incident
"Customer reported receiving a call from fake bank employee"
Tracking graph generated during creation (when trackingGraphParameters provided)

