Telegram Stars: что это и как работает оплата

// Telegram Bot API 8.0+ (актуально на июль 2026)
// Пример на raw fetch — без привязки к конкретной JS-библиотеке

const BOT_TOKEN = process.env.BOT_TOKEN!;
const API = `https://api.telegram.org/bot${BOT_TOKEN}`;

async function tg<T>(method: string, body: Record<string, unknown>): Promise<T> {
  const res = await fetch(`${API}/${method}`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(body),
  });
  const data = (await res.json()) as { ok: boolean; result: T; description?: string };
  if (!data.ok) throw new Error(data.description ?? method);
  return data.result;
}

/** 1. Отправить инвойс в чат (цифровой товар → currency XTR, provider_token пустой) */
export async function sendStarsInvoice(chatId: number) {
  return tg("sendInvoice", {
    chat_id: chatId,
    title: "Pro-доступ",
    description: "Разблокировка Pro-функций бота на 30 дней",
    payload: "pro_access_v1", // до 128 байт, вернётся в updates
    provider_token: "", // обязательно пусто для Stars
    currency: "XTR",
    prices: [{ label: "Pro-доступ", amount: 50 }], // amount — целые Stars, не «копейки»
  });
}

/** 2. Ответить на pre_checkout_query за ≤10 секунд */
export async function approveCheckout(preCheckoutQueryId: string, ok: boolean, errorMessage?: string) {
  return tg("answerPreCheckoutQuery", {
    pre_checkout_query_id: preCheckoutQueryId,
    ok,
    ...(ok ? {} : { error_message: errorMessage ?? "Заказ недоступен" }),
  });
}

type Update = {
  pre_checkout_query?: {
    id: string;
    currency: string;
    total_amount: number;
    invoice_payload: string;
  };
  message?: {
    successful_payment?: {
      currency: string;
      total_amount: number;
      invoice_payload: string;
      telegram_payment_charge_id: string;
    };
  };
};

export async function handleUpdate(update: Update) {
  const pcq = update.pre_checkout_query;
  if (pcq) {
    const valid =
      pcq.currency === "XTR" &&
      pcq.invoice_payload === "pro_access_v1" &&
      pcq.total_amount === 50;
    await approveCheckout(pcq.id, valid, "Некорректный заказ");
    return;
  }

  const payment = update.message?.successful_payment;
  if (payment) {
    // Только после successful_payment можно выдавать товар
    await saveChargeId(payment.telegram_payment_charge_id);
    await grantProAccess(payment.invoice_payload);
  }
}

declare function saveChargeId(id: string): Promise<void>;
declare function grantProAccess(payload: string): Promise<void>;