مارکت پروMARKETPRO DEVELOPER API
مشاهده و دانلود قرارداد PDF پنل کاربری و کلیدها
وب‌سرویس مستقیم فروش خدمات تلگرام

مستندات اتصال وب‌سرویس مارکت‌پرو (MarketPro API)

ربات تلگرام یا وب‌سایت خود را مستقیماً به زیرساخت تأمین مارکت‌پرو متصل کرده و انواع خدمات رسمی تلگرام اعم از اشتراک‌های ۳، ۶ و ۱۲ ماهه پرمیوم، بسته‌های ستاره (Stars) و گیفت‌های نایاب تلگرام را به صورت آنی و خودکار با تسویه ریالی به فروش برسانید.

مراحل فعال‌سازی و سطح احراز API

جهت جلوگیری از سوءاستفاده‌های سایبری، دریافت وب‌سرویس مستلزم تکمیل سطح ۱ (تأیید همراه)،سطح ۲ (احراز هویت فردی و کارت) و سپس سطح ۳ (ارسال قرارداد امضاشده + ویدیوی ۱۲ کلمه‌ای) و تأیید نهایی توسط مدیریت مارکت‌پرو می‌باشد.

الزام احراز هویت خریداران نهایی (ضد فیشینگ)

کلیه سفارش‌های وب‌سرویس با مسئولیت کامل دارنده کلید API ثبت می‌گردد. پذیرنده موظف است احراز هویت کاربران نهایی خود را برای مقابله با فیشینگ و کارت‌های سرقتی مدیریت نماید.

حداقل شارژ ۵۰۰,۰۰۰ تومانی

حداقل مبلغ هر تراکنش شارژ حساب وب‌سرویس مبلغ ۵۰۰,۰۰۰ تومان (معادل ۵,۰۰۰,۰۰۰ ریال) است. این موجودی صرفاً جهت کسر خودکار هزینه سفارش‌های موفق وب‌سرویس تخصیص می‌یابد.

قیمت‌گذاری زنده و لحظه‌ای (Live Pricing)

کلیه قیمت‌ها در تمام متدهای وب‌سرویس (کاتالوگ /products، پیش‌فاکتور /quote و سفارش /orders) به صورت لحظه‌ای و مستقیم بر اساس نرخ زنده ارز و تأمین رسمی تلگرام محاسبه می‌گردند و سفارش‌ها همیشه با بهترین نرخ بازار تسویه می‌شوند.

نمونه کدهای آماده اتصال برای ربات‌های تلگرام

نمونه کامل و تست‌شده به زبان‌های پایتون، نودجی‌اس، پی‌اچ‌پی و کرل

import requests

API_KEY = "mk_live_your_actual_api_key_here"
BASE_URL = "https://marketpro.one/api/v1/bot"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# ۱. استعلام موجودی ریالی کیف پول
def check_balance():
    response = requests.get(f"{BASE_URL}/balance", headers=headers)
    data = response.json()
    if data.get("ok"):
        print(f"موجودی کیف پول: {data['wallet']['formattedToman']} تومان")
        return data["wallet"]["balanceToman"]
    else:
        print("خطا در استعلام موجودی:", data.get("error"))

# ۲. ثبت سفارش تلگرام پرمیوم ۳ ماهه
def buy_telegram_premium(username: str):
    payload = {
        "slug": "telegram-premium-3m",
        "quantity": 1,
        "recipientUsername": username.replace("@", ""),
        "externalOrderId": "BOT-ORDER-1001"
    }
    response = requests.post(f"{BASE_URL}/orders", json=payload, headers=headers)
    res = response.json()
    if response.status_code == 201 and res.get("ok"):
        print(f"سفارش ثبت شد! کد رهگیری: {res['order']['code']}")
        print(f"موجودی باقیمانده: {res['order']['remainingBalanceToman']} تومان")
        return res["order"]
    elif response.status_code == 402:
        print("کسری موجودی! حداقل مبلغ شارژ ۵۰۰,۰۰۰ تومان است.")
    else:
        print("خطا در ثبت سفارش:", res.get("error"))

# ۳. پیگیری سفارش
def check_order_status(order_code: str):
    response = requests.get(f"{BASE_URL}/orders/{order_code}", headers=headers)
    return response.json()

if __name__ == "__main__":
    check_balance()
    # buy_telegram_premium("durov")

فهرست آدرس‌های وب‌سرویس (API Endpoints)

GET/api/v1/bot/balance
استعلام موجودی کیف پول ریالی

مشاهده موجودی ریالی و تومانی حساب کاربری جهت اطمینان از کفایت اعتبار.

GET/api/v1/bot/products
دریافت کاتالوگ محصولات تلگرام

دریافت لیست محصولات فعال (پرمیوم ۳، ۶ و ۱۲ ماهه، استارز، گیفت‌ها) به همراه قیمت زنده.

POST/api/v1/bot/quote
محاسبه پیش‌فاکتور دقیق (Quote)

ارسال slug و quantity جهت دریافت مبلغ دقیق به تومان و ریال قبل از نهایی‌سازی سفارش.

POST/api/v1/bot/orders
ثبت سفارش خودکار تلگرام

کسر آنی از کیف پول ریالی و تحویل فوری اکانت پرمیوم یا استارز به یوزرنیم اعلام‌شده.

GET/api/v1/bot/orders/:code
پیگیری وضعیت تحویل سفارش

استعلام آخرین وضعیت پردازش سفارش در شبکه تلگرام با کد رهگیری یا externalOrderId.

جدول خطاهای استاندارد وب‌سرویس

کد وضعیتعنوان خطاشرح و راهکار رفع خطا
200 / 201عملیات موفقدرخواست با موفقیت اجرا شد و سفارش در صف تحویل قرار گرفت.
400 Bad Requestورودی نامعتبرتعداد کمتر/بیشتر از حد مجاز یا فرمت یوزرنیم تلگرام اشتباه است.
401 Unauthorizedکلید نامعتبرهدر Authorization با کلید صحیح ارسال نشده است.
402 Payment Requiredکسری موجودی ریالیموجودی حساب وب‌سرویس کافی نیست. حداقل شارژ حساب ۵۰۰,۰۰۰ تومان است.
403 Forbiddenعدم احراز هویتمدارک احراز هویت وب‌سرویس (سطح ۳) هنوز تأیید نشده است.
ورود به پنل کاربری و درخواست احراز وب‌سرویس