Skip to content
TonRamp Docs

Quick Start

Accept TON payments in 5 minutes

Section titled “Accept TON payments in 5 minutes”

  1. Become a TonRamp partner

    Partner onboarding is handled by the TonRamp team: your store is registered with the TON wallet that receives payments, and you get an e-mail invite to the partner console (magic-link login).

  2. Create your API key

    In the console, create an API key in the tonr_<prefix>_<secret> format. It is shown only once — store it safely.

  3. Generate the payment link via API

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

    Response:

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

  4. Share the link and the customer pays

    Send the deep_link (or a QR code with it) to your customer. They open the link, choose to pay via Telegram or browser, and confirm the payment.

  5. Track the status

    Set up a webhook to get notified on status changes (recommended), or list your transactions:

    Terminal window
    curl "https://api.tonramp.io/v1/partner/transactions?limit=50" \
      -H "Authorization: Bearer <session-token>"

Iframe Integration

Section titled “Iframe Integration”

Embed the checkout directly on your website:

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

Next steps

Section titled “Next steps”