Pular para o conteúdo principal
POST
Unblock a Pix refund stuck in PROCESSING

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 different URL, X-Account-Id, X-Actor-Id, X-Override-Reason or X-Override-Ticket is PIX-0031 @ 412.

Required string length: 1 - 64
X-Account-Id
string
obrigatório

Source account UUID. A refund that exists under a different account is answered 404.

Exemplo:

"019606a1-3b4c-7d8e-9f01-234567890abc"

X-Actor-Id
string

Optional. Identifies the person in your back office who asked for the check. Pix Lerian does not use it to decide the outcome.

Maximum string length: 255
Exemplo:

"ops-maria"

X-Override-Reason
string

Optional. Reason for the check. Pix Lerian does not use it to decide the outcome.

Maximum string length: 512
Exemplo:

"outcome never arrived"

X-Override-Ticket
string

Optional. Ticket reference in your own back office. Pix Lerian does not use it to decide the outcome.

Maximum string length: 255
Exemplo:

"OPS-4711"

Parâmetros de caminho

id
string
obrigatório

Refund UUID

Exemplo:

"0196080a-1234-7890-abcd-ef0123456789"

Resposta

OK

amount
string
obrigatório
Exemplo:

"100.00"

createdAt
string<date-time>
obrigatório
Exemplo:

"2026-05-06T10:45:00Z"

id
string
obrigatório
Exemplo:

"019606b1-3b4c-7d8e-9f01-234567890dee"

originalEndToEndId
string
obrigatório
Exemplo:

"E12345678202605061030abcdef12345"

reasonCode
string
obrigatório
Exemplo:

"MD06"

status
string
obrigatório
Exemplo:

"COMPLETED"

type
string
obrigatório
Exemplo:

"OUTBOUND"

updatedAt
string<date-time>
obrigatório
Exemplo:

"2026-05-06T10:45:30Z"

accountId
string
Exemplo:

"019606a0-1a2b-7c3d-8e4f-567890123abc"

deletedAt
string<date-time>
description
string
Exemplo:

"Estorno solicitado pelo pagador"

ledger
object
metadata
object
returnEndToEndId
string
Exemplo:

"D12345678202605061045fedcba54321"