Cerrar devolución DICT
Transiciona una devolución de REQUESTED→ACCEPTED|REJECTED con un análisis y la reporta a BACEN.
Autorizaciones
JWT bearer token issued by the identity provider.
Parámetros de ruta
Refund UUID
Cuerpo
closeRefund analysis body
Refund analysis outcome: TOTALLY_ACCEPTED, PARTIALLY_ACCEPTED, or REJECTED
"TOTALLY_ACCEPTED"
Optional free-text analysis details
Effective refunded amount in cents; mandatory when analysisResult is TOTALLY_ACCEPTED or PARTIALLY_ACCEPTED
BACEN rejection reason; mandatory when analysisResult is REJECTED, omit when accepted
Respuesta
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

