> This page is for Internet banking (beta).

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.api.corpx.com/_mcp/server.

# Travas do titular

O dono da conta pode, no internet banking, bloquear saídas, limitar o
horário e restringir os IPs de origem. Essas regras valem contra a **sua**
API do mesmo jeito que valem contra a tela. Você lê o que está em vigor;
quem aperta ou solta a trava é o titular.

## O que a API devolve quando uma trava impede o pagamento

| Código                          | HTTP | Significado                                                     |
| ------------------------------- | ---- | --------------------------------------------------------------- |
| `cashout_locked`                | 423  | Saída bloqueada                                                 |
| `cashout_outside_hours`         | 403  | Fora da janela (horário de Brasília, salvo outro fuso na trava) |
| `cashout_source_ip_not_allowed` | 403  | O IP **desta** chamada ficou de fora da lista do titular        |

Não é falha da sua assinatura. Avise o titular ou espere a janela. A
allowlist de IP da **credencial** (`ip_not_allowed` na borda) é outra
lista — veja [Chaves e IPs](/ib/guias/autenticacao/chaves-e-ips).

## Ler as travas

`GET /v1/accounts/{accountId}/security/locks` (escopo de leitura):

```json
{
  "accountId": "6ff57bc1-e4a9-403b-be62-42378b8aafd7",
  "current": {
    "cashoutBlocked": false,
    "cashoutHours": { "start": "08:00", "end": "18:00", "timezone": "America/Sao_Paulo" },
    "cashoutSourceIps": ["200.10.20.30/32"]
  },
  "pending": null,
  "pendingEffectiveAt": null
}
```

Se o titular pediu um afrouxamento (desbloquear, ampliar horário, incluir
IP), a mudança espera **6 horas** e aparece em `pending` +
`pendingEffectiveAt`. Até lá vale o `current`, mais restrito.

Não há `PUT` dessas rotas nesta credencial. Tentar devolve 403.

## Limites

Leitura, pedido de aumento e teto por operador estão no
[guia de limites](/ib/guias/conta/limites). Travas de horário e IP
continuam nesta página.

## PIN de operador

O PIN existe para a **tela** do banco (credencial do titular). A sua
credencial não envia `X-Transaction-Pin`. Rotas de cadastrar, validar ou
resetar PIN (`/security/pin`) respondem 403 para esta audiência.

## Quem mais opera a mesma conta

`GET /v1/accounts/{accountId}/shared-access` lista outros acessos à mesma
conta bancária: nome de exibição, estado e desde quando. Sem credenciais,
saldo ou configuração dos outros — só o que o titular já vê no
internet banking.