API پذیرنده (توسعه‌دهندگان)
API پذیرنده: برنامه‌ها، صورت‌حساب‌ها، انتقال‌ها و وب‌هوک‌ها.
API پذیرنده چیست؟
API پذیرنده رابط برنامه‌نویسی پرداخت این برنامه برای کسب‌وکارها و ربات‌هاست. یک برنامه‌ی پذیرنده می‌سازید، توکن API آن را می‌گیرید و با همان توکن، از کد خودتان، برای کاربران تلگرام صورت‌حساب صادر می‌کنید، برایشان دارایی می‌فرستید و موجودی‌تان را می‌خوانید.
شروع کار برای توسعه‌دهنده‌ها
در مینی‌برنامه یک برنامه بسازید، توکن API آن را یک بار کپی کنید و فراخوانی API را شروع کنید. همه‌ی این تنظیمات زیر بیشتر ← API پذیرنده جمع شده است.
اتصال یک عامل هوش مصنوعی
یک عامل کدنویسی هوش مصنوعی با پشتیبانی از سرور MCP راه دور را به https://app.tgpaycrypto.com/mcp وصل کنید. عامل می‌تواند مستندات API را بخواند، درخواست ساخت برنامه پذیرنده بدهد، وب‌هوک را تنظیم کند و در نوشتن کد یکپارچه‌سازی کمک کند. شما ساخت برنامه را در ربات تأیید می‌کنید؛ عامل بدون کپی دستی، توکن محدودی دریافت می‌کند. پیش از پذیرش پرداخت واقعی، یکپارچه‌سازی را بازبینی و آزمایش کنید.
دریافت پرداخت با صورت‌حساب
صورت‌حساب راهی است که با آن از یک کاربر تلگرام پول می‌گیرید. آن را با API می‌سازید، لینک آن را برای پرداخت‌کننده می‌فرستید و با پرداخت موفق، مبلغ پس از کسر کارمزد پذیرنده به موجودی برنامه شما اضافه می‌شود.
کارمزد و سقف‌های API پذیرنده
صورت‌حساب‌ها یک کارمزد پلتفرم دارند که از سهم شما کسر می‌شود؛ انتقال‌ها و چک‌ها هم به سقف مبلغ محدودند. عددهای زیر تنظیمات فعلی‌اند، نه شرط قرارداد — هر جا با آنچه در برنامه می‌بینید مطابقت نداشت، ملاک برنامه است و منبع قابل اتکا همیشه صورت‌حساب‌های پرداخت‌شده‌ی خودتان است.
مرجع API پذیرنده
قواعد مشترک همه‌ی متدها، به‌علاوه‌ی متدهای کاتالوگِ فقط‌خواندنی، در همین صفحه آمده است. صفحه‌های متد به متد: صورت‌حساب و بازگشت وجه، انتقال و چک، اشتراک‌ها، وب‌هوک‌ها.
مرجع API: صورت‌حساب و بازگشت وجه
متدهای صورت‌حساب: createInvoice، getInvoices، deleteInvoice، refundInvoice. قراردادهای مشترک (احراز اصالت، قالب پاسخ، مبلغ‌ها، spend_id) در صفحه‌ی مرجع API پذیرنده آمده و راهنمای گام‌به‌گام در دریافت پرداخت با صورت‌حساب.
مرجع API: انتقال و چک
متدهای پرداخت خروجی. انتقال دارایی را از موجودی برنامه‌ی شما به کیف پول یک کاربر تلگرام می‌فرستد، یا تا زمانی که گیرنده‌ی جدید ربات را باز کند نگه می‌دارد؛ چک لینکی برای دریافت دارایی است که مبلغ آن را از پیش تأمین می‌کنید. قراردادهای مشترک (احراز اصالت، قالب پاسخ، مبلغ‌ها، spend_id) در صفحه‌ی مرجع API پذیرنده آمده است.
مرجع API: اشتراک‌ها
صورت‌حساب دوره‌ای — افزوده‌ای بر Crypto Bot. یک طرح می‌سازید (مبلغ + دوره)، لینک تأیید آن را برای کاربران می‌فرستید و پلتفرم هر دوره مبلغ را از موجودی کیف پولشان کسر می‌کند و پس از کسر کارمزد به موجودی برنامه‌ی شما می‌افزاید. قراردادهای مشترک در صفحه‌ی مرجع API پذیرنده آمده است.
مرجع API: وب‌هوک‌ها
وب‌هوک‌ها رویدادها را پس از وقوع به سرور شما می‌فرستند. آدرس وب‌هوک (اختیاری) را برای برنامه‌تان در بیشتر ← API پذیرنده ثبت کنید؛ از آن به بعد پلتفرم برای هر رویدادی که در آن مشترک شده‌اید یک بدنه‌ی JSON امضاشده POST می‌کند.
شرایط API پذیرنده
این شرایط بر API پذیرنده حاکم است — برنامه‌ها، توکن‌های API، صورت‌حساب‌ها، اشتراک‌ها، انتقال‌ها، چک‌ها، وب‌هوک‌ها و اتصال عامل هوش مصنوعی. این شرایط در کنار شرایط عمومی استفاده از برنامه و سیاست AML آن اعمال می‌شود. با ساخت برنامه این شرایط را می‌پذیرید؛ با ادامه‌ی استفاده از برنامه‌ای که پیش از 7 سپتامبر 2026 ساخته شده نیز آن را می‌پذیرید.