Limites de Operações

Início rápido — 2 chamadas

1. Listar os limites da conta:

GET /v1/banking/accounts/{accountId}/operation-limits/presets

Retorna, por modalidade (PIX, TED), cada limite com accountLimit (valor da conta), defaultLimit (teto do produto) e available.

2. Definir um limite:

PUT /v1/banking/accounts/{accountId}/operation-limits/presets/{key}
{ "value": 5000.00 }

→ 202 + requestId. Acompanhe em GET .../operation-limits/requests/{requestId} até APPROVED.

Chaves (key): pix.transacional_diurno, pix.diario_diurno, pix.transacional_noturno, pix.diario_noturno, pix.mensal, ted.transacional, ted.diario, ted.mensal.

Endpoints do grupo

Simples (recomendado — a maioria das integrações usa só estes)

Endpoint	Método	Path
Listar limites da conta	GET	`/v1/banking/accounts/{accountId}/operation-limits/presets`
Definir um limite	PUT	`/v1/banking/accounts/{accountId}/operation-limits/presets/{key}`
Status de uma solicitação	GET	`/v1/banking/accounts/{accountId}/operation-limits/requests/{id}`

Avançado (controle granular por `control`/`rule`)

Endpoint	Método	Path
Criar controle	POST	`/v1/banking/accounts/{accountId}/operation-limits`
Listar controles	GET	`/v1/banking/accounts/{accountId}/operation-limits`
Catálogo de regras do produto	GET	`/v1/banking/accounts/{accountId}/operation-limits/catalog`
Consultar controle	GET	`/v1/banking/accounts/{accountId}/operation-limits/{id}`
Atualizar controle	PUT	`/v1/banking/accounts/{accountId}/operation-limits/{id}`
Remover controle	DELETE	`/v1/banking/accounts/{accountId}/operation-limits/{id}`
Listar regras de um controle	GET	`/v1/banking/accounts/{accountId}/operation-limits/{id}/rules`

No modo avançado, os nomes de control/rule variam por produto — descubra os disponíveis em GET .../operation-limits/catalog. Não use nomes fixos.

Notas

Assíncrono: alterações retornam 202 + requestId (PENDING → APPROVED/REJECTED).
Source of truth é a Dock — a Autra não persiste estado; quem valida na transação é o motor de limites.
Unidade: value em reais (5000.00 = R$ 5.000,00).
Escopo: INDIVIDUAL (por conta) — person_id e product_id resolvidos automaticamente pela Autra a partir do accountId.

Exemplos de payload

PUT — definir um limite

PUT /v1/banking/accounts/{accountId}/operation-limits/presets/pix.diario_diurno
{ "value": 20000.00 }

Resposta 202:

{ "preset": "pix.diario_diurno", "requestId": "uuid", "status": "ACCEPTED" }

GET — listar limites

{
  "accountId": "uuid",
  "modalities": {
    "PIX": [
      { "key": "pix.transacional_diurno", "label": "Transacional diurno",
        "accountLimit": 5000, "defaultLimit": 10000, "configured": true, "available": true }
    ],
    "TED": [
      { "key": "ted.transacional", "label": "Transacional",
        "accountLimit": null, "defaultLimit": 10000, "configured": false, "available": true }
    ]
  },
  "unavailable": []
}

available: false (e a chave listada em unavailable) significa que aquele tipo de limite ainda não está habilitado no produto da conta.