Create a refund under a funds recovery
Creates a local DICT refund bound to the funds recovery (refund-under-recovery, MED 2.0) and reports it to BACEN.
Authorizations
JWT bearer token issued by the identity provider.
Path Parameters
Funds recovery UUID (local record id) the refund is bound to
Body
DICT refund to create under the funds recovery and report to BACEN
Refund amount in integer minor units (BRL centavos); must be greater than zero
150000
BACEN end-to-end identifier (E2E ID) of the PIX transaction to refund
"E1234567820260614ABCDEFGHIJKLMNO"
Free-text justification for the refund request
ISPB (8 numeric digits) of the participant requesting the refund; gated to the calling direct's scope (JRN-151)
"12345678"
Response
Created
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

