For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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.
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.
A faixa por ordem do anúncio pode ser em cripto.limitsUnit: asset com minAssetAmount e maxAssetAmount na criação ou no PATCH; a abertura da ordem compara a quantidade em cripto. minAmount/maxAmount continuam na resposta, em reais ao preço exibido, e por isso andam com o preço. Sem limitsUnit nada muda (brl). Mandar os campos da outra unidade é 400 invalid_payload; trocar de unidade exige a faixa inteira na unidade nova. Mexer na faixa ou no preço de um anúncio em cripto sem cotação da Binance responde 409 price_unavailable.
O tenant pode atestar o contato que já verificou.PUT .../p2p/profile/contact aceita emailVerified e phoneVerified: o canal atestado é gravado confirmado, sem código. O contato do perfil mostra a origem em emailVerifiedBy/phoneVerifiedBy (otp ou tenant).
O apelido troca no máximo uma vez a cada 90 dias. Criar o perfil não conta. Uma segunda troca dentro da carência responde 409 username_change_too_soon com details.nextChangeAt. O perfil traz usernameChangedAt e usernameNextChangeAt.
Rota nova:GET /v1/accounts/{id}/p2p/usernames/{username}/availability responde { username, available } sem dizer de quem é o apelido ocupado.
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.
Mudança de comportamento: a cotação do mercado P2P passa a ser exclusivamente o preço spot da Binance (GET /api/v3/ticker/price?symbol={ATIVO}BRL), lido na hora. Não existe mais agregação de fontes, nem cotação gravada de minuto em minuto, nem regra de idade. GET /v1/p2p/pairs ganha spotSource: "binance"; spotAvailable passa a significar “a Binance respondeu nesta consulta” (cache de até 2 s). O price da lista e do anúncio é indicativo.
A ordem trava o preço numa consulta ao vivo à Binance na abertura, inclusive em anúncio de preço fixo (nesse caso o spot é registrado como o mercado do momento). Se a Binance não responde, POST .../p2p/orders recusa com 409 price_unavailable e nada é criado nem travado; repita com a mesma Idempotency-Key. Replay de ordem existente não consulta a Binance.
Nova rota GET /v1/accounts/{accountId}/p2p/orders/{orderId}/price-evidence: a consulta inteira que travou o preço (request, resposta com todos os headers e corpo cru, TLS e cadeia de certificados, horários, hashes), gravada na mesma transação da ordem e disponível às duas partes desde a abertura. verified recalcula o hash na leitura. Ordem anterior a esta versão responde 404 price_evidence_not_found.
Novo modo de preço offset no anúncio: priceMode: "offset" com offsetCents (centavos por unidade somados ao spot da Binance, com sinal: -1 compra a R0,01abaixo,‘1‘vendeaR 0,01 acima). Teto de 5 % do spot do momento (422 invalid_offset); publicar o anúncio ou mudar o offsetCents sem cotação responde 409 price_unavailable. Editar estoque, limites ou prazo não consulta a Binance nem mede o teto de novo. A taxa continua em bps do valor da ordem em qualquer modo. O enum de priceMode no contrato passa a dizer spread | fixed | offset; o valor floating que o spec mostrava nunca foi aceito.
Contrato: as vias passam a trazer cotacao_binance, cotacao_horario e cotacao_evidencia_sha256. Os templates na Dracma precisam ser recadastrados para os campos aparecerem no PDF; até lá o resto do contrato segue igual.
O preço por unidade do P2P passa a ter 4 casas decimais (5.4321). Vale para o spot da Binance em GET /v1/p2p/pairs, o price do anúncio, o preço travado na ordem, spotPrice e orderPrice da evidência, e os campos preco_unitario e cotacao_binance do contrato. O que já estava gravado não muda de valor: a migração só acrescenta dois zeros.
Só o dinheiro em reais vira centavos, e só na abertura da ordem. O valor da ordem (cripto × preço) trunca ao centavo. A taxa (feeBps do nível, sobre o valor) arredonda ao centavo para cima: fração de centavo não zera.
offset substitui offsetCents no anúncio. É um decimal com sinal e até 4 casas ("-0.0100", "0.0001"), com o mesmo teto de 5 % do spot. offsetCents inteiro continua aceito na requisição (1 centavo vira 0.0100) e sai da resposta. fixedPrice também aceita 4 casas.
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 ruleqrCode.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.
Nova seção med da política. Quando uma disputa (MED) nova é recebida contra a conta, a taxa de MED da janela móvel — MEDs recebidas sobre PIX recebidos com sucesso, por conta, windowDays para trás (padrão 30, teto 90) — é comparada com maxRatePercent. Taxa no teto e pelo menos minMedCount MEDs na janela bloqueiam a saída da conta (423 account_blocked em toda operação de débito até o suporte reativar). A MED segue o fluxo normal.
MEDs críticas, com teto próprio.med.critical tem a mesma forma (maxRatePercent, minMedCount) e conta só as disputas cujo motivo do liquidante é scam-or-fraud ou cujo relato do reclamante traz termos de golpe ou apostas de uma lista mantida pela CorpX, única para todas as contas. Pensada para limites menores que os da taxa geral.
policy.violation com phase: "med". Ação BLOCK_ACCOUNT, accountBlocked, o medId da disputa e os números da janela (windowDays, medCount, criticalMedCount, pixInCount, ratePercent, criticalRatePercent). O pix.med.opened da mesma disputa sai com accountBlocked: true. Regras med.maxRatePercent e med.critical.maxRatePercent. Sem a seção nada muda. Detalhes em Políticas e Regras.
IP novo na allowlist da credencial pode ser liberado antes das 18h. Como já acontecia com a ativação da credencial, a CorpX encerra a carência a pedido do titular, com ticket e a aprovação de um administrador diferente de quem pediu. Os IPs pendentes passam a valer na hora: pendingIps some e eles entram em ips. Nem a credencial nem o master que a emitiu antecipam pela API; incluir IP continua esperando 18h e remover continua valendo na hora. Detalhes em Chaves e IPs.
Novo código payer_key_required (422). Quando a conta pagadora não tem nenhuma chave PIX ativa, o PIX de saída agora falha com payer_key_required em vez de key_inactive. Antes a mensagem mandava conferir a chave do destinatário, mas quem precisa agir é o titular da conta de origem: cadastre uma chave na conta (a aleatória serve) e repita o envio. key_inactive continua valendo para chave do destinatário inativa ou em portabilidade. Detalhes em Erros.
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.
Consulta DICT com janelas de 60 e 90 dias. A seção dictLookup.windows da policy aceita 60d e 90d, além das janelas que já existiam. Quem não declara valores herda a linha de base da frota, revisada nesta versão. Os valores estão em Políticas.
ted.in.received passa a incluir data.payee. A conta que recebeu a TED, como o liquidante a identifica: banco 681 / ISPB 50871921, agência, conta e titular (nome e documento). Até aqui o evento só trazia o pagador. Campo aditivo, schemaVersion continua 1.0. Exemplos em TED e Webhooks.
data.payer do ted.in.received passa a vir completo. Além de nome e documento, o evento traz bankCode, bankIspb, bankName, branch e account do originador, obtidos no extrato do liquidante no momento do aviso. Na rara hipótese de a linha ainda não constar, o evento sai como antes, só com nome e documento. Campos aditivos, schemaVersion continua 1.0. Exemplo em Webhooks.
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 404ad_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.
Abrir ordem P2P só pede PIN e passa pelas travas de saída quando quem abre compra (toma um anúncio de venda), porque é o saldo dele que fica bloqueado. Quem toma um anúncio de compra está vendendo: nada sai da conta dele, e a ordem abre sem X-Transaction-Pin. Liberar continua pedindo o PIN do comprador. Veja P2P Cripto.
Anúncio de compra só recebe ordem quando o anunciante poderia pagar. Num anúncio buy, o valor da ordem é bloqueado na conta do anunciante. Com cashoutBlocked ligado, os anúncios de compra ativos da conta são pausados (pausedReason: cashout_locked), e criar ou religar um responde 423cashout_locked. Fora de cashoutHours, o anúncio sai de GET /v1/p2p/ads e do detalhe (404ad_not_found), e abrir ordem nele responde 409ad_unavailable, até a janela abrir. Na lista do dono, o anúncio escondido traz hiddenReason. Anúncios de venda não mudam. Veja Anúncios.
Endereço do titular PF em PUT /v1/accounts/{accountId}/holder/address, com X-Acting-Document igual ao CPF da conta. PJ usa pedido com comprovante (holder-updates). Veja Cadastro do titular.
Encerrar a conta no caminho exclusivo também recusa se ainda houver chave PIX: 422account_has_pix_keys, só com o tipo da chave.
Contestação de PIX enviado em POST /v1/accounts/{accountId}/pix/med-requests, com código MED-YYYY-NNNNNN. A abertura no liquidante continua sendo da mesa. Veja Contestação de PIX.
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 422account_has_balance. Saldo disponível zerado com saldo bloqueado (por exemplo, retenção de MED) passa a responder 422account_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 reúne as três rotas.
QR Code com vencimento.POST /v1/accounts/{accountId}/pix/qr-code/due-date emite cobrança Pix com dia de vencimento, devedor e, opcionalmente, abatimento, desconto, juros e multa. O QR aceita pagamento até o fim do dia dueDate + daysAfterDueDate (Brasília), no máximo 365 dias à frente. Ver o guia.
Pix Location.POST /v1/accounts/{accountId}/pix/qr-code/location gera o QR bloqueado (status: BLOCKED), que já pode ser impresso. PUT /v1/accounts/{accountId}/pix/qr-code/location/{identifier}/confirm define valor, vencimento e devedor e libera o pagamento. Se a confirmação for recusada, o erro traz details.qrStatus: BLOCKED e o QR continua bloqueado. Ver o guia.
Os dois produtos são habilitados por tenant. Sem a habilitação, as rotas respondem 403 feature_disabled. Usam o escopo qrcode.manage e as regras de política do QR dinâmico.
Consulta, cancelamento e webhooks não mudam de rota. O lookup devolve os campos de vencimento (dueDate, daysAfterDueDate, encargos, finalValue, debtor, receiverName) e, no Location, locationId. Em qrcode.paid, qrcode.expired e qrcode.cancelled, data.type pode valer due-date ou location, e data.amount do qrcode.paid é o valor efetivamente pago.
Dois eventos novos na linha do tempo:qrcode.location_generated e qrcode.location_confirm_failed.