MatchID Docs

Appearance

Migrating Telegram Mini App to MatchID ​

Telegram ​

Github demo

Overview ​

MatchID provides a solution to run your Telegram Mini App independently on your website with little or no efforts, allowing you to leverage MatchID as an authentication and user management solution within your App.

Migration Flowchart

Why Migrate? ​

The Telegram Mini App is a mini-program based on Telegram, designed to create and run applications within Telegram. However, due to its limitations, you may encounter the following issues:

  • The Telegram Mini App cannot be used outside of Telegram ecosystem.
  • The Telegram Mini App requires DApps to migrate to the TON ecosystem.

Migration Steps ​

  1. Integrate using our React SDK
  2. Code a simple login page and place a Login with MatchID button on it. Example is at LoginScreen.tsx
  3. Start by getting a login code
  4. Next launch MatchID Auth Telegram Mini App for user authentication
  5. Poll login status and then proceed with login when the user is back to your telegram mini app
  • ⏳ Polling Timing
js
let attempts = 0;
const maxAttempts = 15;       // ~30 seconds
const delayMs = 2000;         // 2 seconds between checks
  • This means:
  • Total polling time = 15 × 2 seconds = 30 seconds
  • If you believe your users may:
  • Be on slow networks
  • Use older/slower devices
  • Switch context when verifying
  • Then you can adjust maxAttempts and delayMs to be more lenient:
  1. Now fetch user authentication credentials
  2. Finally get user info and save them
  • This is how you can use MatchID as an authentication and user management solution in your App. Plus, you are given the flexibility to choose to migrate to MatchID's SSO login or keep the Telegram account login.