Quick Start

Aceite pagamentos TON em 5 minutos

Torne-se parceiro TonRamp

O cadastro de parceiro é feito pelo time TonRamp: sua loja é registrada com a carteira TON que recebe os pagamentos, e você recebe um convite por e-mail para o console do parceiro (login por magic link).
Crie sua API key

No console, crie uma API key no formato tonr_<prefix>_<secret>. Ela é exibida uma única vez — guarde com segurança.

Gere o link de pagamento via API

curl -X POST https://api.tonramp.io/v1/wallet/trp/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tonr_SUA_API_KEY" \
  -d '{
    "wallet": "UQBJ6gU8gh_jRrzYDlfw9cpCwHaSn2mrK4O-1h8CDENehGYJ",
    "merchant": "minhaloja",
    "amount": 100.00,
    "currency": "USDT",
    "tx_id": "pedido-001"
  }'

Resposta:

{
  "success": true,
  "payload": "trp010148UQBJ6gU8...",
  "deep_link": "https://trp.tonramp.io/trp/trp01...",
  "telegram_link": "https://t.me/TonRmpBot/tonramp?startapp=trp01..."
}

Compartilhe o link e o cliente paga

Envie o deep_link (ou um QR code com ele) ao cliente. Ele abre o link, escolhe pagar via Telegram ou navegador e confirma o pagamento.
Acompanhe o status

Configure um webhook para ser notificado das mudanças de status (recomendado), ou consulte suas transações:
Terminal window
```
curl "https://api.tonramp.io/v1/partner/transactions?limit=50" \
  -H "Authorization: Bearer <token-da-sessao>"
```

Logo, cor da marca e domínio próprio (CNAME para hosted.tonramp.io) no checkout e no console estão em White label.

Integração via Iframe

Incorpore o checkout diretamente no seu site:

<iframe
  src="https://trp.tonramp.io/trp/{payload}"
  width="440"
  height="700"
  style="border: none; border-radius: 12px;"
></iframe>

Próximos passos

Protocolo TRP — entenda o formato do payload
API REST — todos os endpoints disponíveis
Checkout — personalize a página de pagamento
Iframe — integre no seu site