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.
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.
Pix Automático: cobrança recorrente autorizada uma vez pelo pagador. Novas rotas em /v1/accounts/{accountId}/pix/automatic para pedir a autorização da recorrência, emitir QR composto (imediato ou com vencimento), agendar cada cobrança, adiar, consultar as datas de retentativa e pedir a retentativa. Guias em Pix Automático.
Desligado até a CorpX habilitar. A feature automatic_pix nasce off para todos os tenants; com ela off, as rotas respondem 403feature_disabled. Escopo novo da credencial: pix.automatic. Agendar e pedir retentativa são operações financeiras e só aceitam credencial M2M.
Dez webhooks novos.pix.automatic.recurrence.authorized, .rejected, .expired, .failed; pix.automatic.scheduling.confirmed, .rejected, .failed; pix.automatic.settlement.completed, .failed; e pix.automatic.qrcode.paid. A liquidação e o pagamento do QR composto também emitem pix.in.completed. Payloads em Webhooks.
Timeline por recorrência.GET /v1/transactions/{recurrenceId}/timeline traz os eventos pix_automatic.* da recorrência, dos agendamentos e das liquidações.
Códigos de erro novos.automatic_pix_* para contrato bloqueado, recebedor inelegível, banco do pagador indisponível, recorrência não autorizada, data fora da janela, conflito de agendamento, retentativa não permitida, valor acima do limite do pagador, valor incompatível e identificador de QR repetido.
Quatro eventos novos acompanham o beneficiário de boleto.boleto.charge.beneficiary.approved (cadastro aceito ou relacionamento reativado), boleto.charge.beneficiary.rejected (operação recusada, com rejectionCode e rejectionReason), boleto.charge.beneficiary.updated (dados ou elegibilidade alterados) e boleto.charge.beneficiary.closed (relacionamento encerrado). operationId é o mesmo da resposta 202 da operação. Assine em POST /v1/webhooks ou consulte GET /v1/webhooks/events. Veja Webhooks.
GET /v1/accounts/{accountId}/boleto/charge/beneficiary traz lastEvent. O campo repete o último aviso do liquidante. No 404, o aviso vem em details.lastEvent. Assim um cadastro recusado aparece mesmo sem beneficiário criado.
A emissão não refaz por 24 horas um cadastro recusado. Se o liquidante recusou o cadastro do beneficiário nas últimas 24 horas, a emissão (avulsa ou disparo de lote) responde 502boleto_charge_beneficiary_registration_failed com o motivo, details.lastEvent e o header Retry-After com os segundos que faltam, sem enviar outro cadastro. Depois de corrigir os dados da conta, recadastre com POST /v1/accounts/{accountId}/boleto/charge/beneficiary: esse endpoint não espera o prazo. Beneficiário em análise sem recusa recente segue com o 202 de sempre.
Pagamento de boleto emitido atualiza a cobrança mais cedo. O aviso de liquidação do liquidante dispara a releitura da cobrança. Os eventos de pagamento continuam os mesmos.
Bloqueios de saldo.POST /v1/accounts/{accountId}/holds trava parte do saldo no liquidante; o bloqueio é liberado para outra conta CorpX (com taxa opcional para uma terceira) ou cancelado. GET /balance ganha heldAmount. GET .../holds?status=held lista só o que ainda segura saldo, e a soma bate com heldAmount. Eventos account.hold.created, account.hold.released e account.hold.cancelled. Veja Bloqueios de saldo.
P2P Cripto. Mercado de stablecoins em livro único da CorpX: contas de todo tenant com a feature ligada anunciam e tomam anúncios entre si, com regras globais e a contraparte anônima. Inclui anúncios, ordens, bloqueio do valor do comprador, contrato assinado pelas duas partes, conferência do txid na rede, liberação com PIN e disputas decididas pela CorpX. A feature p2p_crypto nasce desligada para todos os tenants. Veja P2P Cripto.
A taxa de intermediação é paga pelo anunciante. Num anúncio de venda, sai da conta do vendedor logo depois do recebimento; num de compra, entra no bloqueio do comprador. Veja Dinheiro e taxa.
Ordem com timeline e comprovante.GET .../p2p/orders/{orderId} traz timeline, deadlineAt, concluded e concludedAt. GET .../p2p/orders/{orderId}/receipt devolve o comprovante da negociação concluída, o único lugar em que as partes se identificam (documento mascarado).
Extrato e webhooks reconhecem a ordem. Transferências com identifier p2p-{orderId}, fee-p2p-{orderId} e fee-p2p-{orderId}-r saem como COMPRA P2P CRIPTO, VENDA P2P CRIPTO, TAXA INTERMEDIAÇÃO KYC P2P CRIPTO ou ESTORNO TAXA INTERMEDIAÇÃO KYC P2P CRIPTO, com partnerType: P2P_CRYPTO_ORDER, p2pOrderId, p2pKind, p2pOrder e contraparte ORDEM P2P CRIPTO. O detalhe da linha traz p2pNegotiation. Bloqueios de ordem trazem source. Veja Extrato e saldo.
Prefixos reservados.identifier começando com fee- ou p2p- é recusado com 400 invalid_identifier em transferências internas, PIX e cobranças.