Exemplos de Uso

Gerando um payload

Dados de entrada

Campo	Valor
Wallet	`UQBJ6gU8gh_jRrzYDlfw9cpCwHaSn2mrK4O-1h8CDENehGYJ`
Merchant	`store123`
Amount	`100,00 USDT` (= 10000 centavos)
Currency	`USDT`
TX ID	`tx123456`

Construção passo a passo

1. Prefixo:        trp01
2. Campo 01 (48):  0148UQBJ6gU8gh_jRrzYDlfw9cpCwHaSn2mrK4O-1h8CDENehGYJ
3. Campo 02 (08):  0208store123
4. Campo 03 (05):  030510000
5. Campo 04 (04):  0404USDT
6. Campo 05 (08):  0508tx123456
7. CRC input:      trp010148UQBJ6gU8gh_jRrzYDlfw9cpCwHaSn2mrK4O-1h8CDENehGYJ0208store1230305100000404USDT0508tx1234569904
8. CRC calculado:  5D57
9. Campo 99 (04):  99045D57

Payload final

trp010148UQBJ6gU8gh_jRrzYDlfw9cpCwHaSn2mrK4O-1h8CDENehGYJ0208store1230305100000404USDT0508tx12345699045D57

Links gerados

A partir do payload, três tipos de link podem ser gerados:

Link Universal

https://trp.tonramp.io/trp/{payload}

Detecta a plataforma automaticamente e redireciona para Telegram ou Web.

Deep Link Telegram

https://t.me/TonRmpBot/tonramp?startapp={payload}

Abre diretamente o bot TonRmpBot no Telegram.

Link Web (Miniapp)

https://miniapp.tonramp.io?startapp={payload}

Abre o checkout no navegador web.

Validando um payload

Python

from app.utils.trp import parse_trp_payload

payload = "trp010148UQBJ6gU8...99045D57"
data = parse_trp_payload(payload)

if data["crc_valid"]:
    print(f"Merchant: {data['merchant']}")
    print(f"Amount: {data['amount']} centavos")
    print(f"Currency: {data['currency']}")
else:
    print("CRC inválido!")

TypeScript

import { parseTrpPayload } from '@/utils/trp'

const data = parseTrpPayload(payload)

if (data.crc_valid) {
  console.log(`Merchant: ${data.merchant}`)
  console.log(`Amount: ${data.amount} centavos`)
  console.log(`Currency: ${data.currency}`)
} else {
  console.log('CRC inválido!')
}

QR Code

QR Code data = https://trp.tonramp.io/trp/{payload}

Recomendações:

Nível de correção: M (15%)
Tamanho mínimo: 200x200px
Fundo branco, código preto