> ## Documentation Index
> Fetch the complete documentation index at: https://docs.troqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Acompanhe as mudanças públicas mais relevantes da documentação da TroqPay.

# Changelog

Esta página registra mudanças públicas relevantes da documentação da TroqPay.

## 2026-06-18

### API pública de links de pagamento

* nova API pública de links de pagamento cobrindo `POST /v1/payment-links`, `GET /v1/payment-links` e `GET /v1/payment-links/{paymentLinkId}`
* `POST /v1/payment-links` exige o scope `PAYMENT_LINK:CREATE`, o header `Idempotency-Key` e o campo `productId` no body, com `expiresInSeconds`, `successUrl` e `returnUrl` opcionais
* `GET /v1/payment-links` exige o scope `PAYMENT_LINK:READ` e retorna uma lista paginada por cursor (`limit` + `cursor` na query); `GET /v1/payment-links/{paymentLinkId}` exige o scope `PAYMENT_LINK:READ`
* a resposta não inclui campo `url`: traz `paymentLinkId` e os campos do link; o link resolve em `pay.troqpay.com/l/{paymentLinkId}`
* não há operações de atualização, exclusão ou ativação/desativação de links via API
* os scopes `PAYMENT_LINK:CREATE` e `PAYMENT_LINK:READ` passam a ser emitidos por padrão em toda chave nova (test e live); chaves antigas não os possuem e recebem `403 api_key_scope_forbidden` até serem reemitidas

## 2026-06-05

### Sincronização do `llms.txt`

* `https://www.troqpay.com/llms.txt` e `https://docs.troqpay.com/llms.txt` passaram a compartilhar o mesmo conteúdo
* `troqpay-website/public/llms.txt` ficou como fonte primária de edição
* `troqpay-docs/llms.txt` voltou a espelhar esse conteúdo para manter paridade pública

## 2026-05-16

### SDK JavaScript e plugin para agentes

* nova página `SDK JavaScript` com uso de `@troqpay/sdk` para checkouts, saldo e saques
* nova página `Claude e Codex` documentando o plugin MCP da TroqPay
* Quickstart atualizado com exemplo TypeScript além do `curl`
* `llms.txt` atualizado com recursos do SDK e ferramentas MCP para agentes

## 2026-05-09

### Saques pela API

* nova página de Saques cobrindo `POST /v1/withdrawals` e `GET /v1/withdrawals/{withdrawalId}`
* documentação pública atualizada para refletir que saques são live-only, exigem conta aprovada, destino aprovado, saldo disponível, permissão de saque e `Idempotency-Key`
* `flows/errors.mdx` atualizado com códigos de erro de saque e `rate_limit_exceeded` como erro aplicável
* `llms.txt` e OpenAPI atualizados para agentes e integrações seguirem o mesmo contrato

## 2026-04-30

### Correções de precisão

* `flows/errors.mdx`: removido nome de provedor interno; adicionados `account_suspended` e `live_operations_blocked` à tabela de códigos
* `glossary.mdx`: `productionAccessStatus` substituído por descrição dos estados de aprovação sem expor nome de campo interno
* `flows/checkouts-pix.mdx` e `flows/liquidacao.mdx`: `settlement.amount` documentado como `string | null` — null para checkouts ainda não liquidados
* `llms.txt` atualizado para refletir as mesmas correções

## 2026-04-25

### Novos fluxos e documentação alinhada

* nova página de Saldo cobrindo `GET /v1/balance` com tabela de campos e aviso de precisão decimal em JavaScript
* nova página de Links de pagamento explicando o ciclo app → URL → checkout
* página de Liquidação reescrita: settlement é sempre em BRL; saques foram descritos no fluxo então vigente
* `llms.txt` publicado com índice legível por máquina dos endpoints e páginas públicas

## 2026-03-28

### Documentação mais guiada

* reforço do onboarding em `Bem-vindo`, `Quickstart`, `Sandbox` e `Produção`
* explicações mais práticas sobre o fluxo `requisição -> pagamento -> webhook -> conciliação`
* finais de página com próximos passos e caminhos de continuidade

### Webhooks e produção mais profundos

* página de webhooks ampliada com cadastro no app, reentregas, ordem dos eventos e resposta esperada do endpoint
* página de produção com checklist mais concreto e sinais para acompanhar nas primeiras cobranças reais

### Mais recursos para integração

* nova página de `Boas práticas de checkout`
* novo `Glossário`
* OpenAPI enriquecido com descrições, exemplos e headers mais claros

## 2026-03-27

### Primeira versão pública da docs

* onboarding base da API
* quickstart para checkout Pix
* autenticação, sandbox e produção
* checkouts Pix, webhooks, erros e liquidação em `USDT`
* API Reference com OpenAPI nativo do Mintlify

## Como usar esta página

<Tip>
  Use o changelog para entender mudanças na documentação pública. Quando o contrato da API mudar, esse é um bom lugar para registrar impacto e data.
</Tip>