Skip to main content
Hypertron does not use email addresses or passwords. Your Stellar wallet is your identity. When you connect Freighter, Hypertron reads your public key and links it to a business account — this happens automatically and requires no form submission. You are the only one who can authorize transactions because your private key never leaves Freighter.

​
Install Freighter

Freighter is a browser extension available for Chrome, Firefox, and Brave.
1

Download the extension

Go to freighter.app and click the download link for your browser. The extension installs in seconds.
2

Create or import a wallet

When Freighter opens for the first time, you can either:
  • Create a new wallet — Freighter generates a new Stellar keypair and shows you a 12-word recovery phrase.
  • Import an existing wallet — Enter your existing 12- or 24-word recovery phrase to restore a wallet you already own.
Write down your recovery phrase and store it somewhere safe and offline. Anyone with your recovery phrase has full control of your wallet. Hypertron cannot recover a lost phrase.
3

Configure your network

Hypertron connects to either Stellar testnet or mainnet. Your Freighter wallet must be on the same network as the Hypertron instance you are connecting to.In Freighter, open the extension and click the network selector in the top-right corner:
  • Select Test Net if you are connecting to a Hypertron testnet instance
  • Select Main Net if you are connecting to a production instance
If you are evaluating Hypertron for the first time, use testnet. You can fund a testnet wallet for free using Stellar Friendbot.

​
Connect Freighter to your dashboard

1

Open the dashboard

Navigate to /dashboard. If Freighter is not yet connected, you will see a Connect with Freighter button in the center of the screen.
2

Click Connect with Freighter

Clicking the button triggers a Freighter popup asking whether you want to grant the site access to your public key. Review the request, then click Connect.Freighter shares only your public key (G... address) — it never exposes your private key or seed phrase.
3

Complete onboarding

The first time you connect, Hypertron creates a business account linked to your wallet address and walks you through a short onboarding flow to set your business name and preferences. This takes under a minute.After onboarding, your dashboard loads with your virtual balance, payment history, and payment link management.

​
What connecting does

When you click Connect with Freighter, the following happens:
  1. Freighter returns your Stellar public key to the Hypertron frontend.
  2. The frontend sends your public key to /api/business/link.
  3. If no business account exists for that public key, one is created automatically.
  4. If a business account already exists, it is returned along with your receive address and balance data.
Your public key serves as your unique identifier within Hypertron. Payment links you create, payments you receive, and withdrawals you request are all scoped to this key.
Disconnecting from the dashboard clears your session in the current browser tab only. It does not delete your business account. Your data and virtual balance are still there the next time you connect with the same wallet.

​
Testnet vs mainnet

NetworkFreighter settingWhat it means
TestnetTest NetPayments use test XLM; free to experiment
MainnetMain NetPayments use real XLM on the live Stellar network
Make sure Freighter’s selected network matches the network your Hypertron instance is configured for. If they do not match, payment transactions will fail to submit.

​
Troubleshooting

​
The “Connect with Freighter” button does nothing

Hypertron detects whether Freighter is installed before showing the connect button. If clicking the button opens a new tab to freighter.app, the extension is not detected — install it and refresh the page.

​
Freighter popup appears but then closes with no result

This usually means you dismissed the popup or clicked Deny. Click Connect with Freighter again and approve the connection request in the Freighter popup.

​
”Could not connect to backend” error after connecting

The dashboard is unable to reach the Hypertron API. Contact your Hypertron administrator to verify that the backend service is running and reachable from your network.

​
Payments fail with a network error

Your Freighter network must match the Hypertron instance’s network. Open Freighter and check which network is selected (Test Net or Main Net). If it does not match what the Hypertron dashboard is using, switch Freighter to the correct network and reconnect.

​
I connected the wrong wallet

Disconnect from the dashboard using the Disconnect button (visible in the top navigation when connected). Then re-open Freighter, switch to the correct account, and connect again. Each Stellar public key has its own isolated business account in Hypertron.