​

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