Cancel a Funds Recovery Request
Use this endpoint to cancel a funds recovery request. Cancellation is allowed before refund has been initiated (CREATED, TRACKED, AWAITING_ANALYSIS, or ANALYSED status).
Notes:
- Cancelled requests cannot be reopened or modified
- Cancellation is not allowed for requests in REFUNDING, COMPLETED, or CANCELLED status
Authorizations
JWT bearer token issued by the identity provider.
Headers
Account ID (UUID) from X-Account-Id header
Path Parameters
Funds Recovery ID (UUID format)
Response
OK
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"

