Refresh DICT refund from BACEN
Fetches the refund’s current record from BACEN (getRefund) and projects the counterparty-determined outcome onto the local row verbatim: no computation, no interpretation. No scheduler runs this — the operator triggers it explicitly.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
Required key used to prevent replaying the mutation.
Parâmetros de caminho
BACEN-assigned refund resource UUID; a local record UUID never resolves here
Resposta
OK
Persisted local DICT refund request record
Refund amount as an exact decimal number
1500
Record creation timestamp (RFC 3339, UTC)
"2026-06-14T12:00:00Z"
BACEN end-to-end identifier (E2E ID) of the refunded PIX transaction
"E12345678202607101200D3E4F5A6B7C"
BACEN-assigned refund resource UUID — the public, canonical identity of this record
"550e8400-e29b-41d4-a716-446655440001"
BACEN refund reason: FRAUD, OPERATIONAL_FLAW or PIX_AUTOMATICO
"FRAUD"
BACEN report delivery state. Always SENT at rest (a resource row is persisted only once BACEN has confirmed it; a rejected or ambiguous attempt creates no row).
"SENT"
ISPB (8 numeric digits) of the participant that requested the refund
"12345678"
DICT spec refund lifecycle state: OPEN, CLOSED, or CANCELLED. CLOSED alone does not say accept vs reject; see analysisResult.
OPEN, CLOSED, CANCELLED "OPEN"
Last update timestamp (RFC 3339, UTC)
"2026-06-14T12:00:00Z"
Free-text analysis details accompanying analysisResult; omitted until close (ours or the counterparty's, via refresh)
closeRefund analysis outcome: TOTALLY_ACCEPTED, PARTIALLY_ACCEPTED, or REJECTED; omitted until close
TOTALLY_ACCEPTED, PARTIALLY_ACCEPTED, REJECTED "TOTALLY_ACCEPTED"
BACEN's own operational envelope for its most recent interaction on this refund, including its LastModified version; omitted when no BACEN interaction has ever landed on it.
When BACEN created this refund request (RFC 3339, UTC); distinct from createdAt
"2026-06-14T12:00:00Z"
BACEN-assigned contested participant ISPB (ExtendedRefund.ContestedParticipant)
"87654321"
MED 2.0: effective refunded amount recorded on an accepting close (exact decimal, verbatim); omitted until close
750
BACEN-assigned funds-recovery id this refund is bound to (refund-under-recovery); omitted for a standalone refund
"550e8400-e29b-41d4-a716-446655440003"
BACEN-assigned infraction this refund was opened for (ExtendedRefund.InfractionReportId); omitted otherwise
"550e8400-e29b-41d4-a716-446655440004"
MED 2.0: whether the destination account is monitored (ExtendedRefund.MonitorAccount); omitted when BACEN has never echoed a value, explicit true/false once it has
true
Durable operation-intent id that produced this snapshot's current state, when known
"01930000-0000-7000-8000-000000000000"
MED 2.0: destination account of a refund-under-recovery; omitted for a standalone refund
Short description of why the refund was requested; present when the reason carries one
BACEN-executed refund transaction id (ExtendedRefund.RefundTransactionId), distinct from endToEndId; empty until a refund transaction exists
"E99999010202606141430ZYXWVUTSRQP"
BACEN rejection reason accompanying a REJECTED analysisResult; omitted otherwise
"NO_BALANCE"
BACEN-assigned requesting participant ISPB (ExtendedRefund.RequestingParticipant)
"12345678"

