> 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.

# Início rápido

> **Beta**
>
> A API de Internet banking está em **beta** — só para usuários convidados pelo
> banco. Veja o aviso em [A API da sua conta](/ib/guias/comece-aqui/visao-geral).

Do internet banking até o primeiro saldo. Reserve uns minutos e um servidor
com relógio sincronizado (NTP): a assinatura recusa um desvio maior que 5
minutos.

## Antes de começar

1. Guarde `clientId`, `clientSecret`, `X-Tenant-Id` e `accountId` em variáveis
   de ambiente — não em repositório.
2. A chave **privada** fica só no servidor que vai assinar. A pública foi
   cadastrada na emissão da credencial; anote o `kid`. Ainda não gerou o
   par? Veja [Gerar o par de chaves](/ib/guias/autenticacao/par-de-chaves).
3. O IP de saída desse servidor precisa estar na allowlist da credencial.
4. Espere o `activeFrom` (18 horas após a emissão). Antes disso, qualquer
   chamada responde `403 credential_not_yet_active`. Isso é proteção, não um
   defeito.

Se a credencial ainda não existe, peça ao titular para emiti-la no internet
banking do banco, colando a chave pública que você gerou —
[o passo a passo](/ib/guias/autenticacao/par-de-chaves)
mostra o que preencher.

Código completo, do token ao primeiro PIX, em
[Exemplos de código](/ib/guias/autenticacao/exemplos-de-assinatura).

## 1. Pedir o token

O token vale **5 minutos**. Guarde-o e reutilize até perto de expirar — um
token por request esgota o emissor e pode ser recusado.

```bash
curl -X POST "https://auth.api.corpx.com/oauth2/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=$CLIENT_ID" \
  -d "client_secret=$CLIENT_SECRET"
```

```json
{
  "access_token": "eyJraWQiOiJ…",
  "expires_in": 300,
  "token_type": "Bearer"
}
```

## 2. Conferir a assinatura sem mover dinheiro

Toda chamada a `https://client.api.corpx.com/v1/**` leva, além do token e do
`X-Tenant-Id`:

| Header                | Valor                                                                              |
| --------------------- | ---------------------------------------------------------------------------------- |
| `X-Request-Timestamp` | Unix em segundos (o mesmo da string canônica)                                      |
| `X-Content-SHA256`    | SHA-256 do corpo em hex minúsculo. Corpo vazio = hash do vazio                     |
| `X-Request-Signature` | JWS detached — veja [Assinatura](/ib/guias/autenticacao/assinatura-de-requisicoes) |

Antes do primeiro saldo, use `POST /v1/security/signature/verify`. Ele devolve
a string canônica que **nós** montamos e `valid: true|false`, sem criar nada.
Quando `valid` é `false`, compare `canonicalString` caractere a caractere com
a sua: o problema quase sempre é CRLF, path sem query ou timestamp em
milissegundos.

Há um [vetor de teste](/ib/guias/autenticacao/assinatura-de-requisicoes#vetor-de-teste) com chave pública,
string canônica e JWS prontos para validar a implementação offline.

## 3. Primeiro saldo

Com a assinatura conferida:

```bash
curl -X GET "https://client.api.corpx.com/v1/accounts/$ACCOUNT_ID/balance" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-Id: $TENANT_ID" \
  -H "X-Request-Timestamp: $TS" \
  -H "X-Content-SHA256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
  -H "X-Request-Signature: $SIG"
```

`GET` não tem corpo: o hash é sempre o do vazio, acima.

```json
{
  "accountId": "6ff57bc1-e4a9-403b-be62-42378b8aafd7",
  "total": 18254.17,
  "locked": 500.00,
  "available": 17754.17,
  "currency": "BRL",
  "updatedAt": "2026-02-05T22:00:00Z"
}
```

Valores monetários são BRL com no máximo 2 casas decimais.

Se você apontar esta credencial para `https://tenant.api.corpx.com`, a
resposta é `403 signed_host_required`. O host antigo não verifica assinatura
por request.

## 4. Confirmar quem você é

`GET /v1/me` (também no host assinado) devolve `clientId`, `scopes` e os
contextos em que o token vale. Use para conferir que o `X-Tenant-Id` que você
vai enviar está na lista.

## Checklist do primeiro dia

* [ ] Token reutilizado até `expires_in`
* [ ] `POST /v1/security/signature/verify` com `valid: true`
* [ ] `GET /v1/accounts/{accountId}/balance` no host `client.api.corpx.com`
* [ ] Relógio do servidor com NTP
* [ ] Chave privada fora do repositório e de logs

## Depois

* [Autenticação](/ib/guias/autenticacao/oauth2) — headers e o que a credencial alcança
* [Gerar o par de chaves](/ib/guias/autenticacao/par-de-chaves) — `openssl`, impressão digital, cadastro e rotação
* [Assinatura](/ib/guias/autenticacao/assinatura-de-requisicoes) — string canônica, Node, vetor de teste
* [Exemplos de código](/ib/guias/autenticacao/exemplos-de-assinatura) — bash, Node.js, Python e Go completos
* [Sua conta](/ib/guias/conta/saldo-e-extrato) — extrato, dados bancários, exportações
* [Receber](/ib/guias/conta/receber) e [Pagar](/ib/guias/conta/pagar)
* [Webhooks](/ib/guias/conta/webhooks) — `accountId` é obrigatório
* [Ir para produção](/ib/guias/referencia/go-live)

Contrato: [Referência da API](/ib/referencia). Filtre operações com
`x-audience` contendo `ib`.