TunnelSats Public Wireguard API
  1. Cookbook
TunnelSats Public Wireguard API
  • About our team
  • 📢 Public
    • List Servers
      GET
    • Create Subscription
      POST
    • Check Status / Heal
      GET
    • Claim Subscription
      POST
    • Renew Subscription
      POST
    • Get Subscription Status
      POST
  • 🔐 Authenticated
    • List My Subscriptions
      GET
    • Sync Subscription
      POST
    • Create Referral Code
      POST
    • Referral History
      GET
  • Announcements
    • 💫 What is TunnelSats?
    • 🚀 Introducing the TunnelSats Public API v1
  • Cookbook
    • 🛠️ Automation & Code Examples
    • 🐚 Bash One-Liners
    • 🛑 Error Codes & Troubleshooting
    • 🎁 Referral Program: Earn Bonus Months
  • Schemas
    • Server
    • InvoiceOrder
    • SubscriptionStatus
    • WireGuardConfig
    • ReferralCode
    • ReferralHistory
    • NodeLookup
    • ConnectivityResult
  1. Cookbook

🎁 Referral Program: Earn Bonus Months

The TunnelSats Referral Program allows developers and partners to earn bonus VPN months by onboarding new users. Whether you are building a node management dashboard or sharing your code with the community, you can automate your rewards.

📈 How It Works#

Partners earn bonus time based on the subscription duration purchased by the referred user.
Plan PurchasedBonus Earned by Partner
3-Month Plan+1 Month Free
6-Month Plan+2 Months Free
12-Month Plan+3 Months Free

🛠️ Developer Integration#

You can integrate your referral code directly into the programmatic purchase flow to ensure every new subscription is linked to your account.
Linking a Referral
Managing Codes
[Referral during Creation]
Include your referralCode in the initial POST /create request to track the conversion from the start.
Request Example:
Create Subscription

💡 Partner Best Practices#

[Transparent Pricing]
Referral bonuses are applied only to 3, 6, and 12-month plans. Standard 1-month subscriptions do not trigger referral bonuses.
[Automatic Application]
Bonus months earned via the referral program are automatically added to your primary active subscription linked to your API key. If you have multiple subscriptions, the bonus is applied to the one with the nearest expiry date.
Modified at 2026-02-15 19:26:00
Previous
🛑 Error Codes & Troubleshooting
Next
Server
Built with