# Paid Media Auto-Purchase

### Overview

Paid Media Auto-Purchase automatically purchases and forwards paid media content from channels that require payment to view locked photos or videos. Perfect for aggregating premium content without manual intervention.

#### What It Does

* Detects paid/locked media in source messages
* Automatically purchases using Telegram Stars or subscription
* Forwards the unlocked content to your targets
* Tracks transactions automatically
* Works seamlessly in background

#### Key Benefits

✅ **Hands-free operation** - No manual purchases needed\
✅ **Complete automation** - Set and forget\
✅ **Transaction tracking** - See all purchases in history\
✅ **Works globally** - All your tasks automatically\
✅ **Respects limits** - Uses your Telegram spending settings

***

### How It Works

#### Processing Flow

1. **Message arrives** with paid/locked media
2. **Bot detects** content requires payment
3. **Auto-purchase** using your Telegram Stars balance
4. **Unlock content** and download media
5. **Forward** the unlocked media to targets
6. **Log transaction** in your credit history

**Processing time**: 2-5 seconds per paid media message

#### Payment Methods

Paid Media uses your **Telegram Stars** balance or channel subscriptions:

* **Telegram Stars**: Bot spends Stars from your account
* **Channel subscriptions**: If you're subscribed, content is included

**Important**: Ensure you have sufficient Telegram Stars balance before enabling.

***

### Getting Started

#### Prerequisites

1. ✅ Have Telegram Stars in your account (purchase via Telegram app)
2. ✅ Purchase Paid Media addon
3. ✅ Source channels use Telegram's paid media feature

#### Quick Setup

**Step 1: Purchase Addon**

1. Menu → My Addons
2. Find **Paid Media Auto-Purchase**
3. Tap **Unlock** and purchase with credits

**Step 2: Enable in Task**

1. Open your task settings
2. Find **Paid Media** toggle (usually in Advanced Settings)
3. Toggle **Paid Media** to ON
4. Save task

**That's it!**

The addon works automatically whenever paid media is encountered.

***

### Configuration

#### No Configuration Needed!

Paid Media is a simple toggle - ON or OFF. No additional settings required.

**Per-task control**: Enable/disable for each task independently.

**Global addon**: Once purchased, available to enable in any task.

***

### Understanding Costs

#### Who Pays?

**You pay** for the paid media using your Telegram Stars balance.

**Cost per message**: Varies by channel (typically 5-50 Stars per photo/video)

**Addon cost**: Credits to unlock the addon (one-time per duration)

**Telegram Stars**: Purchased separately via Telegram app

#### Cost Example

```
Addon cost: 100 credits (for 30 days)
Per media cost: 10 Stars (set by channel)
100 paid photos forwarded = 1000 Stars spent

Total: 100 credits + 1000 Stars
```

#### Managing Spending

**Set limits in Telegram**:

1. Open Telegram Settings
2. Privacy & Security → Stars
3. Set spending limits

**Bot respects** your Telegram spending limits automatically.

***

### Common Use Cases

#### Premium Content Aggregation

**Scenario**: You curate exclusive content from premium channels selling unique photos/videos.

**Setup**: Enable Paid Media in curation task. Bot auto-purchases and forwards content.

**Result**: Your audience gets premium content without individual purchases.

#### Adult Content Forwarding

**Note**: Many adult/NSFW channels use paid media. Paid Media addon handles purchases automatically.

#### Exclusive News/Photos

**Scenario**: News channels selling exclusive photos (celebrity, paparazzi, etc.)

**Setup**: Enable Paid Media. Bot purchases and shares with your audience.

***

### Troubleshooting

#### Issue: Paid Media Not Purchasing

**Check**:

* [ ] Paid Media addon is active (not expired)
* [ ] Paid Media toggle is ON in task
* [ ] You have Telegram Stars balance
* [ ] Source actually uses Telegram's paid media feature (not external payment)

**Fix**: Verify each item above, especially Stars balance.

***

#### Issue: Running Out of Stars

**Symptoms**: Bot stops purchasing after some messages

**Cause**: Telegram Stars balance depleted

**Fix**:

1. Open Telegram app
2. Go to Settings → Stars
3. Purchase more Stars
4. Bot resumes auto-purchasing

***

#### Issue: Spending Too Much

**Problem**: Addon purchasing more than you want

**Solutions**:

* **Set Telegram spending limits** (recommended)
* **Disable addon** in specific tasks
* **Monitor your Stars balance** regularly
* **Calculate expected costs** before enabling

**Prevention**: Test on one task with spending limit first, then expand.

***

#### Issue: Some Media Not Unlocking

**Possible causes**:

* Not paid media (bot can't unlock manually-restricted content)
* Channel uses external payment system (not Telegram Stars)
* Insufficient Stars at time of purchase
* Channel changed pricing after first detection

**Fix**: Verify channel uses Telegram's native paid media feature.

***

### Best Practices

#### Monitor Your Stars Balance

Check balance regularly, especially when forwarding from multiple premium sources.

#### Set Spending Limits

Use Telegram's built-in spending limits to prevent overspending:

* Settings → Stars → Spending Limit

#### Calculate Expected Costs

Before enabling:

1. Note channel's price per media (e.g., 10 Stars)
2. Estimate posts per day (e.g., 5 posts)
3. Calculate daily cost: 10 × 5 = 50 Stars/day
4. Monthly cost: 50 × 30 = 1500 Stars

#### Test on Limited Task First

Enable on one task with low volume to understand costs before scaling.

#### Track Transactions

Check your credit transaction history to monitor spending:

* Menu → Credit Transactions → Filter by "Paid Media"

#### Combine with Content Filters

Use Paid Media with media filters to only process specific content types (photos vs videos).

***

### Frequently Asked Questions

#### Do I need a subscription to premium channels?

No, Paid Media works without subscriptions. It purchases individual posts using Stars.

**However**: If you DO have a subscription, bot uses that (no Stars spent).

#### Can I set a per-message spending limit?

Not directly in addon. Use Telegram's global spending limits instead.

#### What happens if I run out of Stars mid-forward?

Bot stops purchasing. Message forwards without media (or skips message entirely, depending on task settings).

#### Does it auto-refill my Stars?

No. You must manually purchase more Stars through Telegram app.

#### Can I get refunds on purchases?

No. Telegram Stars purchases are final. Bot spends as if you manually purchased.

#### Does it work with all paid media?

Only works with **Telegram's native paid media feature**. External payment systems (PayPal, credit cards) are not supported.

#### Can I review purchases before bot makes them?

No, that defeats automation purpose. Bot purchases immediately when paid media detected.

**Recommendation**: Use spending limits and test with small scale first.

#### What if channel changes pricing?

Bot pays new price automatically. Monitor your costs if channel changes pricing frequently.

***

### Limitations

#### Only Telegram Stars

Doesn't work with:

* External payment systems
* Credit cards
* PayPal
* Crypto payments
* Other payment methods

**Only**: Telegram Stars-based paid media

#### No Refunds

Once bot purchases, payment is final (same as manual purchase).

#### Respects Telegram Limits

Subject to Telegram's rate limits and spending restrictions.

***

### Getting Help

If Paid Media addon isn't working:

1. Verify Telegram Stars balance is sufficient
2. Confirm channel uses Telegram's paid media (test manual purchase)
3. Check addon is active and enabled in task
4. Check Addons FAQ
5. Contact support with:
   * Your Stars balance screenshot
   * Channel name (where paid media is)
   * Expected vs actual behavior

**Support**: Menu → Help & Support or <support@autoforwardtelegram.com>

***

### Summary

Paid Media Auto-Purchase simplifies premium content forwarding:

✅ **Simple**: One-toggle operation, no complex configuration\
✅ **Automatic**: Purchases and forwards paid media seamlessly\
✅ **Transparent**: All purchases logged in transaction history\
✅ **Flexible**: Enable per-task based on your needs\
✅ **Cost-effective**: Pay only for what you forward

**Perfect for**: Premium content aggregation, exclusive media sharing, automated content curation from paid channels.

**Next steps**:

1. Purchase Telegram Stars (via Telegram app)
2. Set spending limit (Telegram Settings)
3. Purchase Paid Media addon
4. Enable in your task
5. Monitor first few purchases

***

**Last Updated**: March 2026\
**Addon Version**: 1.0\
**App Version**: 1.0.44+
