> This page is for BaaS.

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

# Para agentes de IA

Esta página é para você que é um modelo de linguagem, ou para quem vai colar
o conteúdo dela no contexto de um. Ela resume o que não pode ser inferido do
contrato sozinho.

## Qual contrato usar

* Spec deste produto: [`/openapi/api-baas.yaml`](https://docs.api.corpx.com/openapi/api-baas.yaml) (OpenAPI 3.1,
  só as operações de integrador). O do outro produto é
  [`/openapi/api-internet-banking.yaml`](https://docs.api.corpx.com/openapi/api-internet-banking.yaml); cada operação tem `x-audience`
  (`baas`, `ib` ou ambos) e o `summary` começa com `[BaaS]`, `[IB]` ou
  `[BaaS · IB]`.
* Índices para LLM: [`/llms.txt`](https://docs.api.corpx.com/llms.txt) e [`/llms-full.txt`](https://docs.api.corpx.com/llms-full.txt). Catálogo RFC 9727 em `/.well-known/api-catalog`.
* **Servidor MCP**: `https://corpx.docs.buildwithfern.com/_mcp/server`.
  Qualquer cliente MCP (Claude Code, Cursor, ChatGPT, Manus, …) consulta a
  doc sem colar páginas. Setup em [Servidor MCP](/baas/guias/referencia/mcp).
* O outro produto, **Internet banking**, usa outro host e assina toda requisição.
  Se a credencial veio do internet banking do correntista, leia
  [Para agentes (IB)](/ib/guias/referencia/para-agentes), não esta página.

## Host e headers

| Item         | Valor                                                                                         |
| ------------ | --------------------------------------------------------------------------------------------- |
| Base URL     | `https://tenant.api.corpx.com` (server `tenant` no spec)                                      |
| Token        | `POST https://auth.api.corpx.com/oauth2/token`, `client_credentials`, `Authorization: Bearer` |
| Tenant       | `X-Tenant-Id` em toda chamada `/v1/**`                                                        |
| Idempotência | `Idempotency-Key` (UUID) em toda escrita; sem header, `identifier` no corpo cumpre o papel    |
| Assinatura   | Não. `X-Request-Signature` e `X-Content-SHA256` são do produto IB.                            |

## Regras que o spec não expressa

1. **Dinheiro é `number` em BRL com duas casas.** `150.50`, nunca string, nunca centavos.
2. **`identifier` é seu e é único por conta.** Ele volta no extrato, no lookup e nos webhooks. Reutilizar devolve `409 duplicate_identifier`.
3. **Assíncrono é o padrão para pagamento.** `POST .../pix/out/async` devolve `202` e o resultado vem em `pix.out.completed` / `pix.out.failed` / `pix.out.timeout`. `timeout` é indeterminado: consulte o extrato antes de repetir.
4. **Erros são um enum aberto.** Decida por `errorCode`; código desconhecido = erro genérico do mesmo status. Tabela em [Erros](/baas/guias/referencia/erros); cada resposta traz `docs` e `requestId`.
5. **Webhooks têm envelope fixo** (`id`, `type`, `occurredAt`, `data`). `id` é determinístico: deduplique por ele. Assinatura `X-Signature` = `base64(HMAC_SHA256(secret, corpo_bruto))` (Base64 padrão, com padding).
6. **Datas são RFC 3339 em UTC com `Z`** na entrada; algumas leituras do liquidante vêm em `-03:00`. Não assuma fuso.
7. **Documentos (CPF/CNPJ) só dígitos.** Chaves PIX de telefone com `+55`.

## Ordem de leitura sugerida

1. [Primeiros passos](/baas/guias/comece-aqui/primeiros-passos)
2. [OAuth2](/baas/guias/autenticacao/oauth2) e [Idempotência](/baas/guias/comece-aqui/idempotencia)
3. O guia da capacidade que você vai integrar (Receber, Pagar, Abertura de contas). Dropdown de TED/PIX: `GET /v1/banks` (COMPE + ISPB na mesma linha).
4. [Webhooks](/baas/guias/conta/webhooks) e [Erros](/baas/guias/referencia/erros)
5. A [Referência da API](/baas/referencia) para o shape exato de cada campo