Cancel DICT refund
Transitions a refund REQUESTED→CANCELLED (payer side, while still open) and reports it to BACEN.
Authorizations
JWT bearer token issued by the identity provider.
Path Parameters
Refund UUID
Response
OK
Persisted local DICT refund request record
Refund amount in integer minor units (BRL centavos)
150000
Record creation timestamp (RFC 3339, UTC)
"2026-06-14T12:00:00Z"
BACEN end-to-end identifier (E2E ID) of the refunded PIX transaction
"E1234567820260614ABCDEFGHIJKLMNO"
Server-assigned refund record UUID
"550e8400-e29b-41d4-a716-446655440001"
Free-text justification for the refund request
BACEN report delivery state: PENDING, SENT, or FAILED (FAILED is retryable; the local record stands)
"SENT"
ISPB (8 numeric digits) of the participant that requested the refund
"12345678"
Local refund lifecycle state: REQUESTED, ACCEPTED, REJECTED, SETTLED, or CANCELLED
"REQUESTED"
Last update timestamp (RFC 3339, UTC)
"2026-06-14T12:00:00Z"
MED 2.0: effective refunded amount in cents recorded on an accepting close (verbatim); omitted until close
75000
Local funds-recovery id this refund is bound to (refund-under-recovery); omitted for a standalone refund
"550e8400-e29b-41d4-a716-446655440003"
MED 2.0: whether the destination account is monitored
true
MED 2.0: destination account of a refund-under-recovery; omitted for a standalone refund

