Skip to main content
POST
Refresh DICT refund from BACEN

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency
string
obrigatório

Required key used to prevent replaying the mutation.

Parâmetros de caminho

id
string<uuid>
obrigatório

BACEN-assigned refund resource UUID; a local record UUID never resolves here

Resposta

OK

Persisted local DICT refund request record

amount
number
obrigatório

Refund amount as an exact decimal number

Exemplo:

1500

createdAt
string
obrigatório

Record creation timestamp (RFC 3339, UTC)

Exemplo:

"2026-06-14T12:00:00Z"

endToEndId
string
obrigatório

BACEN end-to-end identifier (E2E ID) of the refunded PIX transaction

Exemplo:

"E12345678202607101200D3E4F5A6B7C"

id
string
obrigatório

BACEN-assigned refund resource UUID — the public, canonical identity of this record

Exemplo:

"550e8400-e29b-41d4-a716-446655440001"

reason
string
obrigatório

BACEN refund reason: FRAUD, OPERATIONAL_FLAW or PIX_AUTOMATICO

Exemplo:

"FRAUD"

reportStatus
string
obrigatório

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).

Exemplo:

"SENT"

requestedByISPB
string
obrigatório

ISPB (8 numeric digits) of the participant that requested the refund

Exemplo:

"12345678"

status
enum<string>
obrigatório

DICT spec refund lifecycle state: OPEN, CLOSED, or CANCELLED. CLOSED alone does not say accept vs reject; see analysisResult.

Opções disponíveis:
OPEN,
CLOSED,
CANCELLED
Exemplo:

"OPEN"

updatedAt
string
obrigatório

Last update timestamp (RFC 3339, UTC)

Exemplo:

"2026-06-14T12:00:00Z"

analysisDetails
string

Free-text analysis details accompanying analysisResult; omitted until close (ours or the counterparty's, via refresh)

analysisResult
enum<string>

closeRefund analysis outcome: TOTALLY_ACCEPTED, PARTIALLY_ACCEPTED, or REJECTED; omitted until close

Opções disponíveis:
TOTALLY_ACCEPTED,
PARTIALLY_ACCEPTED,
REJECTED
Exemplo:

"TOTALLY_ACCEPTED"

bacen
object

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.

bacenCreationTime
string

When BACEN created this refund request (RFC 3339, UTC); distinct from createdAt

Exemplo:

"2026-06-14T12:00:00Z"

contestedISPB
string

BACEN-assigned contested participant ISPB (ExtendedRefund.ContestedParticipant)

Exemplo:

"87654321"

effectiveRefundedAmount
number

MED 2.0: effective refunded amount recorded on an accepting close (exact decimal, verbatim); omitted until close

Exemplo:

750

fundsRecoveryId
string

BACEN-assigned funds-recovery id this refund is bound to (refund-under-recovery); omitted for a standalone refund

Exemplo:

"550e8400-e29b-41d4-a716-446655440003"

infractionReportId
string

BACEN-assigned infraction this refund was opened for (ExtendedRefund.InfractionReportId); omitted otherwise

Exemplo:

"550e8400-e29b-41d4-a716-446655440004"

monitorAccount
boolean

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

Exemplo:

true

originOperationId
string

Durable operation-intent id that produced this snapshot's current state, when known

Exemplo:

"01930000-0000-7000-8000-000000000000"

refundAccount
object

MED 2.0: destination account of a refund-under-recovery; omitted for a standalone refund

refundDetails
string

Short description of why the refund was requested; present when the reason carries one

refundTransactionId
string

BACEN-executed refund transaction id (ExtendedRefund.RefundTransactionId), distinct from endToEndId; empty until a refund transaction exists

Exemplo:

"E99999010202606141430ZYXWVUTSRQP"

rejectionReason
string

BACEN rejection reason accompanying a REJECTED analysisResult; omitted otherwise

Exemplo:

"NO_BALANCE"

requestingISPB
string

BACEN-assigned requesting participant ISPB (ExtendedRefund.RequestingParticipant)

Exemplo:

"12345678"