Can I refund only part of a Stars payment?

No. refundStarPayment takes only user_id and telegram_payment_charge_id — no amount parameter, no partial refunds. Workaround: refund in full, then re-invoice for the kept items; or grant a Stars-equivalent in-bot credit for the disputed portion.

Is there a time limit on Telegram Stars refunds?

Telegram does not document a hard eligibility window. The only API blocker is CHARGE_ALREADY_REFUNDED. In practice, refunds older than ~3–6 months become risky because Telegram may have already settled the original purchase with Apple or Google, opening you to a downstream clawback debit.

Does refunding a subscription charge cancel the subscription?

No. refundStarPayment returns Stars from one charge only. The renewal cycle keeps running. To stop future renewals, also call editUserStarSubscription(user_id, telegram_payment_charge_id, is_canceled=True) against the same charge ID. Refund first, cancel second.

What happens to the user's Stars after a refund?

Immediately credited back to the user's Stars balance. They can spend them on any other Stars surface, withdraw via Fragment where supported, or — in the case of an Apple/Google clawback — see them disappear when the platform refund completes.

Do I have to handle `/paysupport`?

Yes, in practice. Telegram's UI directs users to /paysupport from Settings → Stars. A bot that ignores it leaves the user with no in-chat resolution; the user can then escalate to Telegram, who may debit Stars from your balance to cover the refund. Handle it even with just a "we will reply within 24 hours" response.

Can a user dispute a Stars purchase through Apple or Google?

Yes — Stars are bought via in-app purchase, so platform-level refunds are possible. If a user does this after you delivered the digital good, Telegram can debit equivalent Stars from your bot's balance to compensate. Keep a Stars float against high-value charges.

Telegram Stars Refunds: refundStarPayment How-To

🥷Autogram

Features Pricing How It Works Blog FAQ

Telegram Stars Refunds: refundStarPayment How-To | Autogram