Skip to content

FAQ

Open the Supersim Telegram bot and use the API Key section. Your key is shown only once — save it immediately. If you lose it, regenerate it from the bot.

Top up your wallet inside the Telegram bot (or from the account panel). The balance is shared between the bot and the API.

The API itself is free to use; you only pay for the accounts you purchase.

What is the difference between ready and session?

Section titled “What is the difference between ready and session?”
  • Ready: an already-logged-in Telegram account. You fetch the OTP and log in yourself — most common.
  • Session: the .session + .json files for an account, which you download as a ZIP and use directly in your own client (e.g. Telethon, Pyrogram, MTProto).

Can I download a session for a ready account?

Section titled “Can I download a session for a ready account?”

No. Session downloads are only available for account_type: "session" orders.

Logging the store’s bot out guarantees you are the only active session on the account, and stops the server from receiving further messages. It also cleans up the session files.

The API polls for up to a few minutes and stores the latest code. Try GET /api/v1/otp/{order_id} again later. If it still fails, run POST /api/v1/orders/{order_id}/validate and contact support with the order_id.

Use the validate endpoint to check an account. If an account is invalid, our support team will replace it.

Will I be charged twice if my request times out?

Section titled “Will I be charged twice if my request times out?”

No — as long as you send an Idempotency-Key header. The same key returns the same order without charging again.

Not in this version. Ensure your endpoint returns 2xx quickly and is reachable over HTTPS.

The URL is stored on our side and sent nothing else. Anyone who knows the URL can receive your OTP events, so keep it secret and use HTTPS.

10 requests per 10 seconds per API key. See Errors & Rate Limits.

Contact support and we can raise the limits for your key.