# 🎁 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 Purchased | Bonus 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.

<Tabs>
<TabItem value="create" label="Linking a Referral">

:::tip [[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:**

```bash
curl -s -X POST https://tunnelsats.com/api/public/v1/subscription/create \
  -H "Content-Type: application/json" \
  -d '{
    "serverId": "eu-de",
    "duration": 3,
    "referralCode": "YOUR_PARTNER_CODE"
  }'

```

[Create Subscription API Reference](https://api.tunnelsats.com/create-a-new-vpn-subscription-4063129e0.md)

</TabItem>
<TabItem value="management" label="Managing Codes">

:::info [[Automated Tracking]]
Authenticated users can programmatically manage their referral infrastructure.
:::

1. **[Create Referral Code](https://api.tunnelsats.com/universal-connectivity-probe-4063135e0.md):** Generate a new unique tracking code.
2. **[Referral History](https://api.tunnelsats.com/list-all-activepaid-subscriptions-for-the-account-4063136e0.md):** Retrieve a list of successful referrals and bonuses.

</TabItem>
</Tabs>

---

## 💡 Partner Best Practices

:::warning [[Plan Restrictions]]
Referral bonuses are applied only to **3, 6, and 12-month plans**. Standard 1-month subscriptions do not trigger referral bonuses.
:::

:::note [[Automatic Application]]
Bonus months are automatically added to your **primary active subscription** linked to your authenticated account.
:::