Visão Geral do Protocolo TRP

O TRP (TON Ramp Protocol) é um formato de payload para pagamentos na blockchain TON, inspirado no formato EMV/PIX brasileiro.

Início Rápido

Dica

O TRP não é compatível com PIX. Ele apenas usa a mesma estrutura de campos CAMPO(2) + TAMANHO(2) + VALOR.

• Prefixo obrigatório: trp01
• Estrutura: CAMPO(2) + TAMANHO(2) + VALOR
• Validação: CRC16-CCITT no campo 99
• Deep Link: https://t.me/TonRmpBot/tonramp?startapp=\{payload\}
• Link Universal: https://trp.tonramp.io/trp/\{payload\}

Como funciona

1. O comerciante gera um payload TRP com os dados do pagamento
2. O payload é codificado em um link universal ou QR code
3. O comprador escaneia o QR code ou clica no link
4. O sistema detecta a plataforma e redireciona:
   • Telegram: abre o bot TonRmpBot
   • Web: abre o miniapp no navegador
5. O comprador confirma e realiza o pagamento na blockchain TON

Moeda suportada

Moeda	Código	Descrição
Tether USD (rede TON)	USDT	Valor cobrado em USDT diretamente, sem conversão fiat

O merchant cobra diretamente em USDT. O comprador assina uma transferência USDT via TonConnect na rede TON.

Segurança

• CRC16-CCITT: valida a integridade do payload contra erros de transmissão
• HMAC-SHA256 (opcional): assinatura criptográfica que impede adulteração intencional do payload (campo 06)
• Token de status: consulta de status requer token de prova de conhecimento, impedindo enumeração de transações
• Validação server-side: campos são validados no servidor antes do processamento
• Checkout restrito a parceiros: a página oficial só renderiza pagamentos destinados à carteira de um parceiro cadastrado (anti-phishing)
• Tamanho máximo: 512 caracteres por payload
• Wallet: validação de formato (10-48 caracteres)
• Amount: valor positivo e numérico, com teto de 100.000 USDT por pagamento

Estorno e disputa

Uma transferência USDT confirmada na rede TON não pode ser revertida pela TonRamp. A política de estorno, prazos e canais de suporte está em Política de estorno e disputa.