Release a balance block on an infraction report
Releases an incremental balance block and relays the unlock to the SPI Block Balancer. The call is idempotent: releasing a block that is already RELEASED answers 200 with its current state.
The call answers 409 (PIX-0012) when the block is settling, settled or failed, when the SPI already returned a surplus of the payment, or when the block is PENDING without spiBlockId: its SPI create went unanswered, so repeat the create under its requestRef first. It answers 422 (PIX-0328) when the ledger refuses the release because the account is blocked; the block stays PENDING, and the same call releases it once the account is unblocked. It answers a retryable 502 (PIX-0070, PIX-0071 or PIX-0652) when the SPI fails the unlock, cannot confirm the lock state, or still lists the lock PENDING: repeat the call. A PIX-0652 that persists across repeats can mean that the ledger refuses the fee skip that the MED requires: repeat once overrides.allowFeeSkip is on for the Pix ledger.
A block whose lock still waits for the parked credit of its Pix (AWAITING_CREDIT) is released only after that credit completes: credit the received Pix, then repeat. The report and the block must belong to the authenticated organization, otherwise the call answers 404.
Autorizações
JWT bearer token issued by the identity provider.
Parâmetros de caminho
Infraction report internal ID (UUID format)
"018f8c1d-1234-7abc-9def-000000000001"
Balance block internal ID (UUID format)
"018f8c1d-1234-7abc-9def-000000000002"
Resposta
OK
"1500.00"
"018f8c1d-1234-7abc-9def-000000000002"
"2026-07-15T13:35:00Z"
"018f8c1d-1234-7abc-9def-000000000099"
PENDING, SETTLING, SETTLED, RELEASED, FAILED "RELEASED"

