Pular para o conteúdo principal
POST
Close refund blocks after a manual devolution

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency
string
obrigatório

REQUIRED. Client-supplied replay key, at most 64 bytes. A request without it is refused with PIX-0030 @ 400 before the handler runs. Replaying the same key with a divergent method, URL or body is PIX-0031 @ 412.

Required string length: 1 - 64
X-Correlation-Id
string

Best-effort business correlation id (observability only; never fabricated).

Parâmetros de caminho

id
string
obrigatório

Refund internal ID (UUID format)

Exemplo:

"018f8c1d-1234-7abc-9def-000000000010"

Corpo

application/json
endToEndId
string
obrigatório
Exemplo:

"D12345678202601011210abcdef01234"

explanation
string
obrigatório
Exemplo:

"devolucao conciliada manualmente apos falha do settle"

Resposta

OK

alreadySettled
string
obrigatório
Exemplo:

"200.00"

blocks
object[] | null
obrigatório
blocksStatus
enum<string>
obrigatório
Opções disponíveis:
SETTLED
Exemplo:

"SETTLED"

endToEndId
string
obrigatório
Exemplo:

"D12345678202601011210abcdef01234"

originalAmount
string
obrigatório
Exemplo:

"1000.00"

refundId
string
obrigatório
Exemplo:

"018f8c1d-1234-7abc-9def-000000000010"

settledAmount
string
obrigatório
Exemplo:

"800.00"

surplusAmount
string
obrigatório
Exemplo:

"200.00"