happ://crypto links: how to import an encrypted subscription
- Author
- Dmitry Sokolov, Lead technical writer
- Reviewed by:
- Artem Volkov
- Fact-checked:
- Published:
- , updated
- Guide version:
- 1.0
In short
To import a happ://crypto link, add it to Happ through the clipboard, by scanning a QR code or through a deeplink, the same way as an ordinary subscription. The app recognizes the encrypted address itself and shows the server list after import, but not the subscription address.
A happ://crypto link is an encrypted subscription address, and from the import point of view it is no different from an ordinary one: the same three ways of adding and the same result, a block with servers on the main screen. The difference shows after import: with an encrypted subscription you cannot view, edit or forward the address and server configurations, and decryption happens only inside the app on every request. Connecting, ping and updating such a subscription work like an ordinary one, so the only thing the user loses is the ability to inspect the contents of the link personally.
What you need before importing
To import happ://crypto you only need a ready link from your provider: you do not have to build or decrypt it yourself. The provider has already encrypted the ordinary subscription address on its side, and Happ can read such a link right away, without any extra app setup.
The only thing to check in advance is that the link was copied or delivered in full, without truncation. An encrypted string is longer than an ordinary address, and messengers sometimes corrupt it during automatic formatting.
How to import a happ://crypto link
Get the link from your provider
The provider usually sends it in the account, a support bot or a message, as text or as a QR code.
Result: You have a string starting with happ://crypto, copied or shown in full.
Open the add menu in Happ
Result: The import method menu is open after tapping the “+” button on the main screen.
Choose how to pass the link
All three ways are equivalent. Scanning a QR code is handy if the provider showed it on a screen, and a deeplink works when you tap it right in a message.
Result: The link is pasted from the clipboard, the QR code is scanned or the deeplink is opened.
Wait for the subscription to appear
Result: A new block with a name and a list of servers appeared on the main screen.
Check the ping of the servers
Result: The servers of the subscription show a delay in milliseconds.
Connect to a server
Result: The current connection check shows a delay in ms, not a timeout.
What is available after import and what is not
| Action | Available for happ://crypto |
|---|---|
| Connecting and switching servers | yes |
| Pinging the subscription servers | yes |
| Updating the subscription, including automatic updates | yes |
| Viewing the subscription address | no |
| Viewing or exporting the configuration of an individual server | no |
| Forwarding the subscription to another person | only as a whole, by the original link |
The share function for individual servers of an encrypted subscription does not work. If you need to give access to another person, forward the happ://crypto link itself, not an individual server from the list.
Platform differences
| Platform | happ://crypto import specifics |
|---|---|
| Windows, macOS, Linux | It is convenient to paste the link from the clipboard; from version 4.3.0 the subscription has its own settings page after import. |
| Android, iOS | A deeplink from a support chat opens Happ and offers to add the subscription without manual copying. |
| Android TV, Apple TV | A long encrypted link is awkward to type with a remote, so it is more reliable to add it on a phone first and move it to the TV with a QR code or through Web Import. |
Checking the result
- A new subscription block with a name appeared on the main screen.
- The server list is not empty, and some servers show a ping in milliseconds.
- The chosen server connects, and the current connection check shows a delay.
- There is no share icon next to the servers of this subscription. This is the expected behavior for happ://crypto, not an error.
- The original happ://crypto link is saved somewhere you can add it again from, if needed.
If the import failed
| What you see in Happ | Possible cause | Meaning |
|---|---|---|
| “Clipboard is empty” | The link was not copied before importing | Copy the link first, then tap “+” |
| “The subscription URL is not valid” | The link was cut off or damaged in transit | Copy the full link again |
| “Invalid deeplink URL” | The deeplink is outdated or built with a mistake | Ask the provider for a fresh link |
| “Timeout while adding a subscription” | The provider's subscription server did not respond in time | Try again later; Happ waits about 9 seconds for a reply |
If the error repeats with the same link on different devices, the likely cause is the link itself or the provider's side, not a particular import method. For the general list of messages, see the Errors section.
Key takeaways
- A happ://crypto link is imported in the same three ways as an ordinary subscription: the clipboard, a QR code and a deeplink.
- After import the app shows the subscription's server list, but does not decrypt or display its address to the user.
- You cannot view, edit or forward an individual server of an encrypted subscription: this function is not provided for happ://crypto.
- Ping, connecting and updating an encrypted subscription work exactly like a subscription with an open address.
- If an import fails, the cause is usually the link itself, cut off during copying or expired at the provider, not the fact that it is encrypted.
Frequently asked questions
What should I do if a happ://crypto link does not open through a deeplink from Telegram?
First check that Happ is installed and opens on the device on its own, apart from the deeplink. If the app opens but the subscription is not added, copy the link from the message to the clipboard by hand and start the import with the “+” button in the app. This is an equivalent method if the deeplink did not work for some reason.
Do I need to turn on special settings before importing an encrypted link?
No, Happ needs no preliminary settings for this. The app recognizes the happ://crypto prefix automatically when adding, like any other link scheme, and immediately tries to decrypt the address inside it and request the server list.
Can I import happ://crypto directly on a TV, without a phone?
Technically yes, if the link can be entered or delivered to the device itself: through a QR code from the provider's screen or a deeplink in the TV app. In practice typing a long link with a remote is awkward, so people usually add it on a phone first and move it to Android TV or Apple TV with a QR code.
How do I know an encrypted subscription was imported successfully?
The main sign is a new block with the subscription name and a list of servers on the main screen. If the provider reports traffic and expiry date, they also appear in the block header. No error during adding, together with servers in the list, means the import went through normally.
What if the server list is empty after importing happ://crypto?
There may be no error at all: the provider may simply have returned an empty list. Refresh the subscription by hand and wait, because data sometimes loads with a delay. If the list stays empty, only the provider can check it: the address and the contents of the subscription are hidden from the user, and you cannot view them yourself.
Can I replace one happ://crypto link with another from the same provider?
Yes, add the new link the same way you added the first one, and it creates a separate subscription block. It is better to delete the old subscription only after the new one has confirmed the connection and shown a server list, so that you are not left without working access during the replacement.
Related articles
Related sections
Sources
- Happ documentation: encrypted link — accessed September 28, 2026
- Happ documentation: adding a configuration and a subscription — accessed September 28, 2026
- Happ documentation: errors — accessed September 28, 2026