Cancel a Refund Request
Use this endpoint to cancel a refund request before it is processed.
Notes:
- Cancellation is only allowed for requests in OPEN status.
- Cancelled requests cannot be reopened or modified.
- This operation notifies BACEN and the contested participant.
Autorizaciones
JWT bearer token issued by the identity provider.
Parámetros de ruta
Refund Request ID (UUID format)
Respuesta
OK
Account ID (UUID)
"550e8400-e29b-41d4-a716-446655440000"
BACEN/BTG refund request external identifier
"3d48532f-a1b2-4422-81c3-b7dc852e262b"
ISPB of the contested participant (8 uppercase alphanumeric characters)
"12345678"
Creation timestamp (ISO 8601 UTC)
"2024-01-15T10:30:00Z"
Unique identifier of the refund request (UUID)
"550e8400-e29b-41d4-a716-44665544r001"
Refund amount in BRL (format: 0.00)
"100.50"
Reason for the refund
FRAUD, OPERATIONAL_FLAW, REFUND_CANCELLED "FRAUD"
ISPB of the requesting participant (8 uppercase alphanumeric characters)
"30306294"
Current status of the refund request
OPEN, CLOSED, CANCELLED "OPEN"
Pix End-to-End transaction ID (32 characters)
"E12345678202411241430ABCDEFGHIJK"
Last update timestamp (ISO 8601 UTC)
"2024-01-15T10:30:00Z"
Analysis comments (max 2000 characters)
"Analysis confirms fraud. Refund approved."
Analysis result (if closed)
TOTALLY_ACCEPTED, PARTIALLY_ACCEPTED, REJECTED "TOTALLY_ACCEPTED"
BACEN/BTG funds-recovery identifier resolved via the associated infraction report (read-only, JOIN-derived)
"91d65e98-97c0-4b0f-b577-73625da1f9fc"
Amount effectively refunded in BRL
"100.00"
Related infraction report ID (UUID)
"550e8400-e29b-41d4-a716-44665544f001"
BACEN flag for account monitoring
true
Refund destination account details
Detailed justification (max 2000 characters)
"Customer reports unauthorized transaction"
Rejection reason (if rejected)
NO_BALANCE, ACCOUNT_CLOSURE, INVALID_REQUEST, OTHER "NO_BALANCE"
Refund transaction ID (if accepted, 32 characters)
"E98765432202411241500REFUNDTRANS"

