OpenAPI e SDK

O schema canônico dos endpoints de integração fica em:

GET https://api.tonramp.io/v1/trp/openapi.json

É um recorte do OpenAPI da API: generate, parse, quote, top-up, status, checkout PIX (/v1/c) e os endpoints de parceiro usados na operação (webhook, transações, ticker, stats). Admin, Mini App e filas internas não entram.

Nota

Em produção o /openapi.json completo da API fica desligado. Use só este recorte.

Gerar um client

TypeScript:

npx openapi-typescript https://api.tonramp.io/v1/trp/openapi.json -o trp.d.ts

Python:

pip install openapi-python-client
openapi-python-client generate --url https://api.tonramp.io/v1/trp/openapi.json

Há também um client TypeScript mínimo, só com fetch, em sdk/trp.ts. Serve de referência e pode ser copiado para o seu projeto.

Autenticação no schema

• POST /v1/wallet/trp/generate e POST /v1/c usam Authorization: Bearer tonr_<prefix>_<secret>.
• GET /v1/partner/* usa o JWT da sessão do console.

O demo-trp em demo-trp.tonramp.io mostra o fluxo USDT ponta a ponta.