TRP Protocol Overview
TRP (TON Ramp Protocol) is a payload format for payments on the TON blockchain, inspired by the Brazilian EMV/PIX format.
Quick Start
Section titled “Quick Start”- 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/trp/\{payload\}
How It Works
Section titled “How It Works”- The merchant generates a TRP payload with the payment details
- The payload is encoded into a universal link or QR code
- The buyer scans the QR code or clicks the link
- The system detects the platform and redirects:
- Telegram: opens the TonRmpBot
- Web: opens the miniapp in the browser
- The buyer confirms and completes the payment on the TON blockchain
Supported Currency
Section titled “Supported Currency”| Currency | Code | Description |
|---|---|---|
| Tether USD (TON network) | USDT |
Amount charged directly in USDT, no fiat conversion |
The merchant charges directly in USDT. The buyer signs a USDT transfer via TonConnect on the TON network.
Security
Section titled “Security”- CRC16-CCITT: validates payload integrity against transmission errors
- HMAC-SHA256 (optional): cryptographic signature that prevents intentional payload tampering (field 06)
- Status token: status queries require a proof-of-knowledge token, preventing transaction enumeration
- Server-side validation: fields are validated on the server before processing
- Partner-only checkout: the official page only renders payments addressed to a registered partner’s wallet (anti-phishing)
- Maximum size: 512 characters per payload
- Wallet: format validation (10-48 characters)
- Amount: positive numeric value, capped at 100,000 USDT per payment
Refunds and disputes
Section titled “Refunds and disputes”A USDT transfer confirmed on the TON network cannot be reversed by TonRamp. Deadlines, support channels and what TonRamp will not do are in the Refund and dispute policy.