1. Cookbook
TunnelSats Public Wireguard API
  • About our team
  • 📢 Public
    • List available VPN servers
      GET
    • Create a new VPN subscription
      POST
    • Claim a WireGuard configuration after payment
      POST
    • Check subscription status via payment hash
      GET
    • Renew an existing VPN subscription
      POST
    • Get Subscription Status
      POST
  • 🔐 Authenticated
    • Sync Subscription
      POST
    • Create Referral Code
      POST
    • Referral History
      GET
    • List all active/paid subscriptions for the account
      GET
  • 🔧 Tools
    • Lightning Node Network Address Discovery
      POST
    • Universal Connectivity Probe
      POST
  • Announcements
    • 💫 What is TunnelSats?
    • 🚀 Introducing the TunnelSats Public API v1
    • How TunnelSats Leverages Public APIs for Confined VPN Management
  • Cookbook
    • 🛠️ Automation & Code Examples
    • 🐚 Bash One-Liners
    • 🛑 Error Codes & Troubleshooting
    • 🎁 Referral Program: Earn Bonus Months
    • 🚑 Node Health & Upkeep
    • 🛡️ Security & Authentication
  • Schemas
    • Server
    • InvoiceOrder
    • SubscriptionStatus
    • WireGuardConfig
    • ReferralCode
    • ReferralHistory
    • NodeLookup
    • ConnectivityResult
    • RenewalOrder
    • ClaimResult
    • ApiError
    • SubscriptionListItem
  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 /api/public/v1/subscription/create request to track the conversion from the start.
Request Example:
Create Subscription API Reference

💡 Partner Best Practices#

[Plan Restrictions]
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 are automatically added to your primary active subscription linked to your authenticated account.
Modified at 2026-04-12 13:21:53
Previous
🛑 Error Codes & Troubleshooting
Next
🚑 Node Health & Upkeep
Built with