Skip to content
TonRamp Docs

Quick Start

Accept TON payments in 5 minutes

Section titled “Accept TON payments in 5 minutes”

  1. Open the link generator

    Go to trp.tonramp.io in your browser.

  2. Fill in the payment details

    • TON Wallet: your TON address (e.g., UQxx...)
    • Merchant ID: your store identifier (e.g., mystore)
    • Amount: how much to charge (e.g., 100.00)
    • Currency: BRL, USD, EUR, or TON

  3. Generate the link and share it

    The system generates a universal link like:

    https://trp.tonramp.io/trp010148UQxx...9904ABCD

    Share this link or the QR code with your customer.

  4. Customer pays

    The customer opens the link, chooses to pay via Telegram or browser, and confirms the payment.

  5. Check the status

    Terminal window
    curl "https://api.tonramp.io/api/v1/trp/status/{tx_id}?token={token}"

    The token and tx_id are returned on the checkout page.

API Integration

Section titled “API Integration”

If you prefer to generate payments programmatically:

Terminal window
curl -X POST https://api.tonramp.io/api/v1/wallet/trp/generate \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "UQBJ6gU8gh_jRrzYDlfw9cpCwHaSn2mrK4O-1h8CDENehGYJ",
    "merchant": "mystore",
    "amount": 100.00,
    "currency": "BRL",
    "tx_id": "order-001"
  }'

Response:

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

Use the deep_link to redirect the customer to checkout.

Iframe Integration

Section titled “Iframe Integration”

Embed the checkout directly on your website:

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

Next steps

Section titled “Next steps”