starkerak 0.2.0

StarKerak To'lov Monitoring API va Websocket Client

StarKerak Python SDK

StarKerak xizmatining rasmiy Python kutubxonasi. Bu kutubxona orqali siz o'zingizning domensiz (VPS) ishlayotgan Python botlaringizga to'lov ma'lumotlarini (Telegramdan tushgan SMS cheklarni) Real-Time (Websocket) yordamida qabul qila olasiz.

O'rnatish

Kutubxonani loyihangizga qo'shish uchun quyidagi buyruqni ishlating:

pip install starkerak

Foydalanish (Sinxron oddiy usul)

Kodni alohida script tarzida yurgizish uchun:

from starkerak import StarKerakClient

# API kalitni @CardHelpUzRoBot ga kirib, WebApp "Sozlamalar" bo'limidan olasiz
client = StarKerakClient("API_KALITINGIZ_SHU_YERDA")

@client.on_payment
def tolov_kelganda(payment):
    # To'lov ma'lumotlari JSON shaklida keladi
    print(f"🎉 Pul tushdi! {payment['amount']} UZS")
    print(f"Karta: {payment['card_last4']}")
    # Bu yerda foydalanuvchiga VIP maqomini berish yoki xizmatni yoqish kodingizni yozing

# Kutishni boshlash (bu kod scriptni kutish rejimiga o'tkazadi)
client.start_listening()

Foydalanish (Asinxron - Aiogram bot bilan)

Agar sizda Aiogram bot bo'lsa va bot bilan birga parallel ishlashini xohlasangiz:

import asyncio
from aiogram import Bot, Dispatcher
from starkerak import StarKerakClient

bot = Bot(token="Sizning_Bot_Tokeningiz")
dp = Dispatcher()

# StarKerak ulanishi
sk_client = StarKerakClient("API_KALITINGIZ_SHU_YERDA")

@sk_client.on_payment
async def tolov_kelganda(payment):
    print("Pul tushdi!", payment)
    # Masalan foydalanuvchiga xabar yuborish:
    # await bot.send_message(foydalanuvchi_id, f"Sizdan {payment['amount']} UZS to'lov olinib, VIP yoqildi!")

async def main():
    # Ham botni, ham StarKerakni parallel ishga tushirish
    await asyncio.gather(
        dp.start_polling(bot),
        sk_client.start_listening_async()
    )

if __name__ == "__main__":
    asyncio.run(main())

Afzalliklari

• 0.1 soniyada kelib tushadi (Websocket texnologiyasi asosida)
• Hech qanday Domen, Hosting yoki HTTPS SSL sertifikatlarni talab qilmaydi
• Serveringizga ortiqcha bosim tushmaydi.