Skip to content

TRP Protocol Overview

TRP (TON Ramp Protocol) is a payload format for payments on the TON blockchain, inspired by the Brazilian EMV/PIX format.

  • Required prefix: trp01
  • Structure: FIELD(2) + LENGTH(2) + VALUE
  • Validation: CRC16-CCITT in field 99
  • Deep Link: https://t.me/TonRmpBot/tonramp?startapp=\{payload\}
  • Universal Link: https://trp.tonramp.io/\{payload\}
  1. The merchant generates a TRP payload with the payment details
  2. The payload is encoded into a universal link or QR code
  3. The buyer scans the QR code or clicks the link
  4. The system detects the platform and redirects:
    • Telegram: opens the TonRmpBot
    • Web: opens the miniapp in the browser
  5. The buyer confirms and completes the payment on the TON blockchain
CurrencyCodeDescription
Brazilian RealBRLValue converted to TON at the time of payment
US DollarUSDValue converted to TON at the time of payment
EuroEURValue converted to TON at the time of payment
ToncoinTONDirect value in TON (no conversion)
  • CRC16-CCITT: validates payload integrity, preventing tampering
  • Server-side validation: fields are validated on the server before processing
  • Maximum size: 512 characters per payload
  • Wallet: format validation (10-48 characters)
  • Amount: positive numeric value