Resolve a parked DIRECT permanent attempt

curl --request POST \
  --url https://api.example.com/v1/admin/executor/orders/{orderId}/permanent-attempts/{attemptId}/resolution \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "allocation": [
    {
      "accountId": "0193b2c4-acc1",
      "amount": "10.00"
    }
  ],
  "ledgerEvidence": {
    "kind": "transaction",
    "observedAt": "2026-10-29T11:30:00Z",
    "reference": "midaz-tx-3f9a1c7e"
  },
  "movedAmount": "30.00",
  "reason": "OPS-4512: ledger statement reviewed.",
  "resolution": "effect-acknowledged"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/admin/executor/orders/{orderId}/permanent-attempts/{attemptId}/resolution"

	payload := strings.NewReader("{\n  \"allocation\": [\n    {\n      \"accountId\": \"0193b2c4-acc1\",\n      \"amount\": \"10.00\"\n    }\n  ],\n  \"ledgerEvidence\": {\n    \"kind\": \"transaction\",\n    \"observedAt\": \"2026-10-29T11:30:00Z\",\n    \"reference\": \"midaz-tx-3f9a1c7e\"\n  },\n  \"movedAmount\": \"30.00\",\n  \"reason\": \"OPS-4512: ledger statement reviewed.\",\n  \"resolution\": \"effect-acknowledged\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    allocation: [{accountId: '0193b2c4-acc1', amount: '10.00'}],
    ledgerEvidence: {
      kind: 'transaction',
      observedAt: '2026-10-29T11:30:00Z',
      reference: 'midaz-tx-3f9a1c7e'
    },
    movedAmount: '30.00',
    reason: 'OPS-4512: ledger statement reviewed.',
    resolution: 'effect-acknowledged'
  })
};

fetch('https://api.example.com/v1/admin/executor/orders/{orderId}/permanent-attempts/{attemptId}/resolution', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/admin/executor/orders/{orderId}/permanent-attempts/{attemptId}/resolution"

payload = {
    "allocation": [
        {
            "accountId": "0193b2c4-acc1",
            "amount": "10.00"
        }
    ],
    "ledgerEvidence": {
        "kind": "transaction",
        "observedAt": "2026-10-29T11:30:00Z",
        "reference": "midaz-tx-3f9a1c7e"
    },
    "movedAmount": "30.00",
    "reason": "OPS-4512: ledger statement reviewed.",
    "resolution": "effect-acknowledged"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "attemptId": "<string>",
  "orderId": "<string>",
  "outcome": "RESOLVED",
  "resolution": "<string>",
  "resolvedAt": "2023-11-07T05:31:56Z",
  "resolvedBy": "<string>"
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Resolve a parked DIRECT permanent attempt

The audited resolution of a PARKED DIRECT permanent block attempt (its reactive write failed every retry, or its window passed, so its block account holds every new credit) of a single-tenant deployment (multi-tenant: 422 SBJ-0053). Declaring no effect releases the account: credits resume and the open-order probe lets the order go; the attempt stays FAILED. Acknowledging the effect journals movedAmount as the write’s landed effect: it is added to the permanent’s accumulated amount (the next credit blocks only the remainder; reaching the target closes the block) and the attempt becomes BLOCKED with its result. On a permanent already CLOSED the attempt is SKIPPED_CLOSED, nothing reopens, and closed_with_effect is alarmed. A human platform-administrator action (executor_human_decision:resolve): an application token (SBJ-0044) or a tenant-carrying token (SBJ-0045) is refused with 403. The journal rows, the attempt and the audit row commit in one transaction. 200 outcome NOOP: the same resolution was already journaled. 404: unknown attempt, or one of an institution this executor does not own. 409 SBJ-0061: not parked, or the order is busy. 409 SBJ-0054: the journal shows money moved. 409 SBJ-0055: already resolved as no effect. 422 SBJ-0052: invalid request (the reason is named in the answer, e.g. LEG_ALLOCATION_REQUIRED). 422 SBJ-0062: movedAmount above the cap.

POST

admin

executor

orders

{orderId}

permanent-attempts

{attemptId}

resolution

Resolve a parked DIRECT permanent attempt

curl --request POST \
  --url https://api.example.com/v1/admin/executor/orders/{orderId}/permanent-attempts/{attemptId}/resolution \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "allocation": [
    {
      "accountId": "0193b2c4-acc1",
      "amount": "10.00"
    }
  ],
  "ledgerEvidence": {
    "kind": "transaction",
    "observedAt": "2026-10-29T11:30:00Z",
    "reference": "midaz-tx-3f9a1c7e"
  },
  "movedAmount": "30.00",
  "reason": "OPS-4512: ledger statement reviewed.",
  "resolution": "effect-acknowledged"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/admin/executor/orders/{orderId}/permanent-attempts/{attemptId}/resolution"

	payload := strings.NewReader("{\n  \"allocation\": [\n    {\n      \"accountId\": \"0193b2c4-acc1\",\n      \"amount\": \"10.00\"\n    }\n  ],\n  \"ledgerEvidence\": {\n    \"kind\": \"transaction\",\n    \"observedAt\": \"2026-10-29T11:30:00Z\",\n    \"reference\": \"midaz-tx-3f9a1c7e\"\n  },\n  \"movedAmount\": \"30.00\",\n  \"reason\": \"OPS-4512: ledger statement reviewed.\",\n  \"resolution\": \"effect-acknowledged\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    allocation: [{accountId: '0193b2c4-acc1', amount: '10.00'}],
    ledgerEvidence: {
      kind: 'transaction',
      observedAt: '2026-10-29T11:30:00Z',
      reference: 'midaz-tx-3f9a1c7e'
    },
    movedAmount: '30.00',
    reason: 'OPS-4512: ledger statement reviewed.',
    resolution: 'effect-acknowledged'
  })
};

fetch('https://api.example.com/v1/admin/executor/orders/{orderId}/permanent-attempts/{attemptId}/resolution', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/admin/executor/orders/{orderId}/permanent-attempts/{attemptId}/resolution"

payload = {
    "allocation": [
        {
            "accountId": "0193b2c4-acc1",
            "amount": "10.00"
        }
    ],
    "ledgerEvidence": {
        "kind": "transaction",
        "observedAt": "2026-10-29T11:30:00Z",
        "reference": "midaz-tx-3f9a1c7e"
    },
    "movedAmount": "30.00",
    "reason": "OPS-4512: ledger statement reviewed.",
    "resolution": "effect-acknowledged"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "attemptId": "<string>",
  "orderId": "<string>",
  "outcome": "RESOLVED",
  "resolution": "<string>",
  "resolvedAt": "2023-11-07T05:31:56Z",
  "resolvedBy": "<string>"
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Autorizações

Authorization

string

header

obrigatório

JWT bearer token issued by the identity provider.

Parâmetros de caminho

orderId

string

obrigatório

The executor order's identifier (UUID).

Exemplo:

"0b9b7c2e-4f8a-4d3e-9a51-7c2d1e0f3a44"

attemptId

string

obrigatório

The parked permanent attempt's identifier (UUID).

Exemplo:

"1d2e3f40-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

Corpo

application/json

allocation

object[] | null

Optional per-leg allocation of movedAmount: required when a partial amount of a write of several origin legs is acknowledged (422 SBJ-0052, LEG_ALLOCATION_REQUIRED); it must name the write's own legs once each, each at most its amount, summing to movedAmount (LEG_ALLOCATION_INVALID).

Show child attributes

ledgerEvidence

object

Required: a parked write is uncertain by definition. Its kind is transaction on effect-acknowledged (the reference is journaled as the ledger transaction). observedAt must not be before the attempt's write. Stored only in the sealed audit row.

Show child attributes

movedAmount

string

Required with effect-acknowledged, refused otherwise: the decimal amount above zero the write moved. At most the permanent's remaining while it is open, at most the write's journaled amount always (422 SBJ-0062). Never echoed, logged nor audited.

Exemplo:

"30.00"

reason

string

Required. Short justification or ticket (at most 200 characters, no personal data). Never echoed.

Exemplo:

"OPS-4512: ledger statement reviewed."

resolution

string

Required. proven-no-effect: the ledger shows the parked write never landed; the account is released and new credits resume (the attempt stays FAILED). effect-acknowledged: the write landed movedAmount; it counts toward the permanent block and the attempt becomes BLOCKED.

Exemplo:

"effect-acknowledged"

Resposta

attemptId

string

obrigatório

The permanent attempt's identifier.

orderId

string

obrigatório

The executor order's identifier.

outcome

enum<string>

obrigatório

RESOLVED: journaled now. NOOP: the same resolution was already journaled; nothing changed.

Opções disponíveis:

RESOLVED,

NOOP

resolution

string

obrigatório

The resolution journaled, as requested.

resolvedAt

string<date-time>

obrigatório

Instant of the request (UTC).

resolvedBy

string

obrigatório

Subject of the platform administrator who made the request.

SISBAJUD Mensageria · Instituições

SISBAJUD Mensageria · Ordens e arquivos

SISBAJUD Mensageria · Monitoramento

SISBAJUD Mensageria · Arquivos de retorno

SISBAJUD Mensageria · Solicitações LGPD

SISBAJUD Mensageria · Segurança

SISBAJUD Mensageria · Conformidade

SISBAJUD Mensageria · Dead letter do Lerian STA

SISBAJUD executor · Instituições e conector Midaz

SISBAJUD executor · Canal direto

SISBAJUD executor · Ordens que precisam de atenção

SISBAJUD executor · Roteamento de ledger

SISBAJUD executor · Segurança

SISBAJUD executor · Auditoria

Tratamento de erros

Resolve a parked DIRECT permanent attempt

Autorizações

Parâmetros de caminho

Corpo

Resposta