Telegram Stars & Pembayaran

Keamanan pembayaran

Validasi harga, payload, dan pre-checkout query di server. Jangan percaya state client saat memenuhi konten berbayar.

Permukaan pembayaran

Gunakan Telegram payments untuk invoice dan Stars untuk monetisasi konten digital.

Invoice

Buat flow pembayaran dengan API invoice Telegram.

Buka invoice

Stars

Kelola monetisasi konten digital dengan metode Stars.

Buka Stars

Checkout

Jawab pre-checkout query sebelum fulfillment.

Buka checkout

VibeGram mendukung sistem pembayaran bawaan Telegram, termasuk Telegram Stars untuk monetisasi konten digital.

Mengirim Media Berbayar

bot.command('premium', async ctx => {
    await ctx.replyWithPaidMedia(
        15, // Harga dalam Telegram Stars
        [{ type: 'photo', media: 'https://contoh.com/konten-premium.jpg' }],
        { caption: '📸 Konten Premium — 15 Stars' }
    );
});

Invoice

bot.command('beli', async ctx => {
    await ctx.replyWithInvoice({
        title: 'Keanggotaan Pro',
        description: 'Akses 30 hari ke fitur premium',
        payload: 'keanggotaan_pro_30h',
        provider_token: 'TOKEN_PENYEDIA_PEMBAYARAN',
        currency: 'USD',
        prices: [{ label: 'Keanggotaan Pro', amount: 999 }], // $9.99
    });
});

Pre-Checkout

bot.on('pre_checkout_query', async ctx => {
    // Validasi pesanan sebelum dikenakan biaya
    const payload = ctx.update.pre_checkout_query?.invoice_payload;

    if (payload === 'keanggotaan_pro_30h') {
        await ctx.answerPreCheckoutQuery(true);
    } else {
        await ctx.answerPreCheckoutQuery(false, 'Produk tidak ditemukan.');
    }
});

Pembayaran Berhasil

bot.on('message', async ctx => {
    if (ctx.message?.successful_payment) {
        const pembayaran = ctx.message.successful_payment;
        const jumlah = pembayaran.total_amount / 100; // konversi dari sen

        await ctx.reply(
            `✅ Pembayaran ${jumlah} ${pembayaran.currency} diterima!\n` +
                `ID Transaksi: ${pembayaran.telegram_payment_charge_id}`
        );

        // Aktifkan fitur premium untuk pengguna
        await aktivasiPremium(ctx.from!.id);
    }
});

Refund Telegram Stars

bot.command('refund', async ctx => {
    const chargeId = ctx.command?.args?.[0];
    if (!chargeId) return ctx.reply('Masukkan ID transaksi.');

    await ctx.refundStarPayment(ctx.from!.id, chargeId);
    await ctx.reply('✅ Stars dikembalikan ke pengguna.');
});

Gift Stars (Bot API 9.x)

// Kirim hadiah Stars ke pengguna
bot.command('hadiah', async ctx => {
    const gifts = await ctx.getAvailableGifts();
    const giftId = gifts.gifts[0].id;

    await ctx.sendGift(ctx.from!.id, giftId, {
        text: '🎁 Terima kasih telah menggunakan bot kami!',
    });
});

// Lihat Stars yang dimiliki bot
bot.command('saldo', async ctx => {
    const saldo = await ctx.getStarBalance();
    await ctx.reply(`💫 Saldo Stars bot: ${saldo.amount}`);
});

Riwayat Transaksi

bot.command('transaksi', async ctx => {
    const riwayat = await ctx.getStarTransactions({ limit: 10 });
    const daftar = riwayat.transactions.map(t => `• ${t.amount} Stars — ${t.date}`).join('\n');
    await ctx.reply(`📊 10 Transaksi Terakhir:\n${daftar}`);
});

Tombol Pembayaran di Keyboard

import { Markup } from 'vibegram';

await ctx.reply('Lanjutkan pembelian:', {
    reply_markup: Markup.inlineKeyboard([[Markup.button.pay('💳 Bayar Sekarang')]]),
});