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

# Changelog

## v2.152.0 — Admin: trocar escopos de uma master sem rotacionar o secret

* **Rota nova:** `POST /v1/admin/tenants/{tenantId}/credentials/{clientId}/scopes` (só `admin_super`, com ticket, motivo e solicitante distinto do aprovador). Troca o conjunto de escopos de uma master ativa: acrescenta o que falta (ex.: `credentials.delegate`) ou substitui uma master legada `api2/write` pelo conjunto granular. Recusa reduzir escopos em master granular, recusa mudar o par OAuth do Cognito e grava trilha em `admin_audit_log`. Serve para destravar a emissão de credenciais delegadas pelo internet banking sem rotacionar o `clientSecret`.

## v2.150.0 — P2P exige e-mail e telefone confirmados no perfil

* **O perfil P2P passa a ter contato próprio, confirmado por código.** `PUT /v1/accounts/{id}/p2p/profile/contact` grava `email` e `phone` (e `representativeName` na conta PJ) e envia um código para cada canal ainda não confirmado. `POST .../p2p/profile/contact/confirm` com `channel` (`email` ou `phone`) e `code` confirma o canal; `POST .../p2p/profile/contact/codes` reenvia o código. O `GET` do perfil traz `contact` com os destinos mascarados, `emailVerified`, `phoneVerified` e `ready`.
* **O CPF de quem assina o contrato não vai no corpo.** Na conta PF é o documento da conta. Na PJ é o titular informado em `X-Acting-Document`; se outro titular gravar o contato, as duas confirmações zeram. Trocar o e-mail ou o telefone zera a confirmação daquele canal.
* **Sem os dois canais confirmados, a conta não negocia.** Abrir ordem responde `422 p2p_contact_unverified`; criar ou reativar anúncio e pedir para ser anunciante também. O anúncio de quem não confirmou sai do livro, e uma ordem nele responde `409 ad_unavailable`. Ordens já abertas seguem normalmente (liberar e cancelar não exigem o contato).
* **Perfis que já anunciam precisam confirmar o contato** para voltar ao livro. Não houve cópia do contato do credenciamento.
* Códigos novos: `p2p_contact_unverified`, `contact_code_invalid`, `contact_code_locked`, `contact_code_rate_limited` (429), `contact_delivery_failed` (503) e `contact_already_verified` (409). O código vale 10 minutos, com até 5 tentativas e até 5 envios a cada 15 minutos.

## v2.150.0 — P2P exige e-mail e telefone confirmados no perfil

* **O perfil P2P passa a ter contato próprio, confirmado por código.** `PUT /v1/accounts/{id}/p2p/profile/contact` grava `email` e `phone` (e `representativeName` na conta PJ) e envia um código para cada canal ainda não confirmado. `POST .../p2p/profile/contact/confirm` com `channel` (`email` ou `phone`) e `code` confirma o canal; `POST .../p2p/profile/contact/codes` reenvia o código. O `GET` do perfil traz `contact` com os destinos mascarados, `emailVerified`, `phoneVerified` e `ready`.
* **O CPF de quem assina o contrato não vai no corpo.** Na conta PF é o documento da conta. Na PJ é o titular informado em `X-Acting-Document`; se outro titular gravar o contato, as duas confirmações zeram. Trocar o e-mail ou o telefone zera a confirmação daquele canal.
* **Sem os dois canais confirmados, a conta não negocia.** Abrir ordem responde `422 p2p_contact_unverified`; criar ou reativar anúncio e pedir para ser anunciante também. O anúncio de quem não confirmou sai do livro, e uma ordem nele responde `409 ad_unavailable`. Ordens já abertas seguem normalmente (liberar e cancelar não exigem o contato).
* **Perfis que já anunciam precisam confirmar o contato** para voltar ao livro. Não houve cópia do contato do credenciamento.
* Códigos novos: `p2p_contact_unverified`, `contact_code_invalid`, `contact_code_locked`, `contact_code_rate_limited` (429), `contact_delivery_failed` (503) e `contact_already_verified` (409). O código vale 10 minutos, com até 5 tentativas e até 5 envios a cada 15 minutos.

## v2.147.0 — Taxa do anunciante no perfil P2P

* **Novo campo `feeBps` no perfil P2P.** `GET /v1/accounts/{accountId}/p2p/profile` (e as respostas de `PUT` do perfil e do pedido de anunciante) agora trazem a taxa, em bps do valor da ordem, que a conta paga nas ordens dos próprios anúncios: no anúncio de venda o vendedor recebe o valor menos a taxa; no de compra o comprador paga o valor mais a taxa. Vem do nível; sem nível, vale a taxa do nível mais baixo, como na abertura da ordem. Use para simular o líquido antes de publicar o anúncio.

## v2.147.0 — Taxa do anunciante no perfil P2P

* **Novo campo `feeBps` no perfil P2P.** `GET /v1/accounts/{accountId}/p2p/profile` (e as respostas de `PUT` do perfil e do pedido de anunciante) agora trazem a taxa, em bps do valor da ordem, que a conta paga nas ordens dos próprios anúncios: no anúncio de venda o vendedor recebe o valor menos a taxa; no de compra o comprador paga o valor mais a taxa. Vem do nível; sem nível, vale a taxa do nível mais baixo, como na abertura da ordem. Use para simular o líquido antes de publicar o anúncio.

## v2.147.0 — Taxa do anunciante no perfil P2P

* **Novo campo `feeBps` no perfil P2P.** `GET /v1/accounts/{accountId}/p2p/profile` (e as respostas de `PUT` do perfil e do pedido de anunciante) agora trazem a taxa, em bps do valor da ordem, que a conta paga nas ordens dos próprios anúncios: no anúncio de venda o vendedor recebe o valor menos a taxa; no de compra o comprador paga o valor mais a taxa. Vem do nível; sem nível, vale a taxa do nível mais baixo, como na abertura da ordem. Use para simular o líquido antes de publicar o anúncio.

## v2.141.0 — Cota de criação de QR Code por dia e por mês

* **A seção `qrCode` da política ganha `maxIssuesPerDay` e `maxIssuesPerMonth`.** Quando configuradas, a criação de QR (estático, dinâmico e com vencimento) é recusada com `422 policy_denied` e `rule` `qrCode.maxIssuesPerDay` ou `qrCode.maxIssuesPerMonth` assim que a conta atinge o número de QR criados no dia ou no mês calendário de Brasília. A cota é por conta — configurada no tenant, cada conta tem a sua — e conta todo QR criado na janela, em qualquer status: cancelar não devolve a vaga. Sem as duas chaves nada muda. QR de PIX Automático não entra na contagem. Detalhes em [Políticas e Regras](/baas/guias/autenticacao/politicas).

## v2.141.0 — Cota de criação de QR Code por dia e por mês

* **A seção `qrCode` da política ganha `maxIssuesPerDay` e `maxIssuesPerMonth`.** Quando configuradas, a criação de QR (estático, dinâmico e com vencimento) é recusada com `422 policy_denied` e `rule` `qrCode.maxIssuesPerDay` ou `qrCode.maxIssuesPerMonth` assim que a conta atinge o número de QR criados no dia ou no mês calendário de Brasília. A cota é por conta — configurada no tenant, cada conta tem a sua — e conta todo QR criado na janela, em qualquer status: cancelar não devolve a vaga. Sem as duas chaves nada muda. QR de PIX Automático não entra na contagem. Detalhes em [Políticas e Regras](/baas/guias/autenticacao/politicas).

## v2.141.0 — Cota de criação de QR Code por dia e por mês

* **A seção `qrCode` da política ganha `maxIssuesPerDay` e `maxIssuesPerMonth`.** Quando configuradas, a criação de QR (estático, dinâmico e com vencimento) é recusada com `422 policy_denied` e `rule` `qrCode.maxIssuesPerDay` ou `qrCode.maxIssuesPerMonth` assim que a conta atinge o número de QR criados no dia ou no mês calendário de Brasília. A cota é por conta — configurada no tenant, cada conta tem a sua — e conta todo QR criado na janela, em qualquer status: cancelar não devolve a vaga. Sem as duas chaves nada muda. QR de PIX Automático não entra na contagem. Detalhes em [Políticas e Regras](/baas/guias/autenticacao/politicas).

## v2.141.0 — Cota de criação de QR Code por dia e por mês

* **A seção `qrCode` da política ganha `maxIssuesPerDay` e `maxIssuesPerMonth`.** Quando configuradas, a criação de QR (estático, dinâmico e com vencimento) é recusada com `422 policy_denied` e `rule` `qrCode.maxIssuesPerDay` ou `qrCode.maxIssuesPerMonth` assim que a conta atinge o número de QR criados no dia ou no mês calendário de Brasília. A cota é por conta — configurada no tenant, cada conta tem a sua — e conta todo QR criado na janela, em qualquer status: cancelar não devolve a vaga. Sem as duas chaves nada muda. QR de PIX Automático não entra na contagem. Detalhes em [Políticas e Regras](/baas/guias/autenticacao/politicas).

## v2.136.0 — parâmetros do mercado P2P em GET /v1/p2p/settings

* **Nova rota `GET /v1/p2p/settings`.** Devolve, só leitura, o que o correntista precisa saber antes da primeira ordem: prazo de assinatura (`signingDeadlineMin`), faixa de prazo de entrega (`deliveryMinMin`, `deliveryMaxMin`), prazo de liberação (`releaseDeadlineH`), carência de carteira nova (`walletChangeGraceH`), teto por ordem e diário que valem para o tenant (`orderCap`, `dailyCap`, o menor entre mercado e tenant, `null` sem teto), faixa da taxa de anunciante entre os níveis (`feeBpsMin`, `feeBpsMax`, `null` sem nível) e os pares ligados. Mesmos escopos e mesmo gate `feature_disabled` de `GET /v1/p2p/pairs`. Veja [Primeiros passos](/baas/guias/p2p/primeiros-passos).

## v2.136.0 — parâmetros do mercado P2P em GET /v1/p2p/settings

* **Nova rota `GET /v1/p2p/settings`.** Devolve, só leitura, o que o correntista precisa saber antes da primeira ordem: prazo de assinatura (`signingDeadlineMin`), faixa de prazo de entrega (`deliveryMinMin`, `deliveryMaxMin`), prazo de liberação (`releaseDeadlineH`), carência de carteira nova (`walletChangeGraceH`), teto por ordem e diário que valem para o tenant (`orderCap`, `dailyCap`, o menor entre mercado e tenant, `null` sem teto), faixa da taxa de anunciante entre os níveis (`feeBpsMin`, `feeBpsMax`, `null` sem nível) e os pares ligados. Mesmos escopos e mesmo gate `feature_disabled` de `GET /v1/p2p/pairs`. Veja [Primeiros passos](/baas/guias/p2p/primeiros-passos).

## v2.136.0 — parâmetros do mercado P2P em GET /v1/p2p/settings

* **Nova rota `GET /v1/p2p/settings`.** Devolve, só leitura, o que o correntista precisa saber antes da primeira ordem: prazo de assinatura (`signingDeadlineMin`), faixa de prazo de entrega (`deliveryMinMin`, `deliveryMaxMin`), prazo de liberação (`releaseDeadlineH`), carência de carteira nova (`walletChangeGraceH`), teto por ordem e diário que valem para o tenant (`orderCap`, `dailyCap`, o menor entre mercado e tenant, `null` sem teto), faixa da taxa de anunciante entre os níveis (`feeBpsMin`, `feeBpsMax`, `null` sem nível) e os pares ligados. Mesmos escopos e mesmo gate `feature_disabled` de `GET /v1/p2p/pairs`. Veja [Primeiros passos](/baas/guias/p2p/primeiros-passos).

## v2.136.0 — parâmetros do mercado P2P em GET /v1/p2p/settings

* **Nova rota `GET /v1/p2p/settings`.** Devolve, só leitura, o que o correntista precisa saber antes da primeira ordem: prazo de assinatura (`signingDeadlineMin`), faixa de prazo de entrega (`deliveryMinMin`, `deliveryMaxMin`), prazo de liberação (`releaseDeadlineH`), carência de carteira nova (`walletChangeGraceH`), teto por ordem e diário que valem para o tenant (`orderCap`, `dailyCap`, o menor entre mercado e tenant, `null` sem teto), faixa da taxa de anunciante entre os níveis (`feeBpsMin`, `feeBpsMax`, `null` sem nível) e os pares ligados. Mesmos escopos e mesmo gate `feature_disabled` de `GET /v1/p2p/pairs`. Veja [Primeiros passos](/baas/guias/p2p/primeiros-passos).

## v2.131.0 — detalhe do anúncio P2P

* **`GET /v1/p2p/ads/{adId}` devolve um anúncio do livro.** Os campos são os do item de `GET /v1/p2p/ads`, mais `network`, `asset` e `decimals` do par. A tela de abrir ordem pode carregar o anúncio por link direto ou depois de recarregar. Anúncio inativo ou fora do livro responde **404** `ad_not_found`. A carteira e o tenant do anunciante não aparecem: para abrir a ordem, mande a `walletId` do cliente na rede do par. Veja [Guia do internet banking](/baas/guias/p2p/guia-internet-banking).

## v2.131.0 — detalhe do anúncio P2P

* **`GET /v1/p2p/ads/{adId}` devolve um anúncio do livro.** Os campos são os do item de `GET /v1/p2p/ads`, mais `network`, `asset` e `decimals` do par. A tela de abrir ordem pode carregar o anúncio por link direto ou depois de recarregar. Anúncio inativo ou fora do livro responde **404** `ad_not_found`. A carteira e o tenant do anunciante não aparecem: para abrir a ordem, mande a `walletId` do cliente na rede do par. Veja [Guia do internet banking](/baas/guias/p2p/guia-internet-banking).

## v2.131.0 — detalhe do anúncio P2P

* **`GET /v1/p2p/ads/{adId}` devolve um anúncio do livro.** Os campos são os do item de `GET /v1/p2p/ads`, mais `network`, `asset` e `decimals` do par. A tela de abrir ordem pode carregar o anúncio por link direto ou depois de recarregar. Anúncio inativo ou fora do livro responde **404** `ad_not_found`. A carteira e o tenant do anunciante não aparecem: para abrir a ordem, mande a `walletId` do cliente na rede do par. Veja [Guia do internet banking](/baas/guias/p2p/guia-internet-banking).

## v2.131.0 — detalhe do anúncio P2P

* **`GET /v1/p2p/ads/{adId}` devolve um anúncio do livro.** Os campos são os do item de `GET /v1/p2p/ads`, mais `network`, `asset` e `decimals` do par. A tela de abrir ordem pode carregar o anúncio por link direto ou depois de recarregar. Anúncio inativo ou fora do livro responde **404** `ad_not_found`. A carteira e o tenant do anunciante não aparecem: para abrir a ordem, mande a `walletId` do cliente na rede do par. Veja [Guia do internet banking](/baas/guias/p2p/guia-internet-banking).

## v2.125.0 — Cartões no saldo diário e saldo bloqueado no encerramento

* **Saldo diário mostra a liquidação de cartões.** Cada dia de `GET /v1/accounts/{accountId}/daily-balance` traz `cardSettlementIn` (entradas de débito, crédito e antecipação) e `cardSettlementOut` (saídas). Os dois vêm sempre, com `0` quando não há movimento. Com eles, a abertura de um dia volta a bater com a abertura do dia anterior mais entradas, menos saídas e tarifas.
* **Encerramento distingue saldo bloqueado.** Em `POST /v1/accounts/{accountId}/close`, quando a conta é só sua, o liquidante só encerra conta zerada: sem saldo disponível e sem saldo bloqueado. Saldo disponível continua respondendo **422** `account_has_balance`. Saldo disponível zerado com saldo bloqueado (por exemplo, retenção de MED) passa a responder **422** `account_has_locked_balance`. Nos dois casos a conta segue ativa e o corpo traz o saldo do liquidante.
* **Documentação.** A referência de `GET /v1/accounts/{accountId}/pix/transactions` passa a descrever o que a rota sempre devolveu: o envelope do extrato (`items[]`, schema `AccountStatement`) com 0 ou 1 item, e `200` com `items: []` quando a transação não existe. Quem gerou cliente a partir do schema antigo (`transactionId`, `type`, `transactionDate`) deve regenerá-lo. A referência de `GET /balance` deixa claro que `includeLocks` não tem efeito. O novo guia [Saldo, saldo diário e encerramento](/baas/guias/conta/saldo-e-encerramento) reúne as três rotas.

## v2.125.0 — Cartões no saldo diário e saldo bloqueado no encerramento

* **Saldo diário mostra a liquidação de cartões.** Cada dia de `GET /v1/accounts/{accountId}/daily-balance` traz `cardSettlementIn` (entradas de débito, crédito e antecipação) e `cardSettlementOut` (saídas). Os dois vêm sempre, com `0` quando não há movimento. Com eles, a abertura de um dia volta a bater com a abertura do dia anterior mais entradas, menos saídas e tarifas.
* **Encerramento distingue saldo bloqueado.** Em `POST /v1/accounts/{accountId}/close`, quando a conta é só sua, o liquidante só encerra conta zerada: sem saldo disponível e sem saldo bloqueado. Saldo disponível continua respondendo **422** `account_has_balance`. Saldo disponível zerado com saldo bloqueado (por exemplo, retenção de MED) passa a responder **422** `account_has_locked_balance`. Nos dois casos a conta segue ativa e o corpo traz o saldo do liquidante.
* **Documentação.** A referência de `GET /v1/accounts/{accountId}/pix/transactions` passa a descrever o que a rota sempre devolveu: o envelope do extrato (`items[]`, schema `AccountStatement`) com 0 ou 1 item, e `200` com `items: []` quando a transação não existe. Quem gerou cliente a partir do schema antigo (`transactionId`, `type`, `transactionDate`) deve regenerá-lo. A referência de `GET /balance` deixa claro que `includeLocks` não tem efeito. O novo guia [Saldo, saldo diário e encerramento](/baas/guias/conta/saldo-e-encerramento) reúne as três rotas.

_Showing the 20 most recent of 228 entries. Append `/llms.txt` to the changelog URL for the complete index._