Skip to documentation

Sales

Use Free and Paid Script steps

Choose whether a step delivers open media or a locked Telegram Stars offer and understand the state each one creates.

Edit step delivery
On this page

Overview

Free and Paid steps use the same ordered Script journey but have different commercial results. A Free step delivers without a paywall. A Paid step becomes a locked Telegram Stars offer and opens Waiting Payment only after successful delivery.

  • Choose the correct delivery type for every step.
  • Prepare paid media and Stars pricing before activation.
  • Understand when Waiting Payment starts.

Before you start

  • Select the bot and creator that will use the Script.
  • Prepare usable media in Gallery before adding media-based steps.
  • Decide whether the bot sells Telegram paid media or uses a configured Sell Link path.

Step by step

  1. Open the target step and select the intended Free or Paid delivery behavior.
  2. Attach media that is ready for that delivery type.
  3. For a Paid step, set a valid Stars price and verify paid-media readiness.
  4. Save the Script and run a live test through the step delivery.
  5. Confirm only a successfully sent Paid step opens Waiting Payment for that exact offer.

How it works

These are the product rules and states that matter for this workflow.

What to knowTelestars behavior
Free stepThe media is delivered without a paywall and does not open Waiting Payment.
Paid stepThe media is sent as a locked Telegram Stars object with the configured current price.
Waiting PaymentSelecting a Paid step or writing its caption is not enough; the state begins only after real Telegram delivery.
PurchaseA confirmed purchase completes that paid step and allows the Script to continue toward its next step.

Verify the result

  • Confirm the Script is active, ordered correctly, and ready for its selected selling path.
  • Run a real conversation through the minimum, delivery, and next-state transition.
  • Verify every delivered price, caption, media item, and purchase state matches the saved configuration.

Troubleshooting

If you see thisWhat to check
A Paid step appears as ordinary mediaCheck that the asset is paid-media ready and that the step has a valid Stars price.
Waiting Payment opened without a visible cardDo not continue selling that state; verify the actual Telegram delivery and retry the step through the normal path.
A Free step started negotiationConfirm the current active offer belongs to a separate successfully delivered Paid step.

Best practice

Launch with one fully verified Script before adding more paths, then test every delivery and purchase transition in Telegram.

You’re ready

You now know how to use free and paid script steps

Use the verification checklist above on the real Telegram path before considering the setup complete.

Next: Create a Sell Link Script

Did this article answer your question?

Your feedback helps us make Telestars easier to use.