API پذیرنده (توسعهدهندگان)
API پذیرنده: اپها، صورتحسابها، انتقالها و وبهوکها.
API پذیرنده چیست؟
API پذیرنده رابط برنامهنویسی پرداخت این برنامه برای کسبوکارها و رباتهاست. یک برنامهی پذیرنده میسازید، توکن API آن را میگیرید و با همان توکن، از کد خودتان، برای کاربران تلگرام صورتحساب صادر میکنید، برایشان پول میفرستید و موجودیتان را میخوانید.
شروع کار برای توسعهدهندهها
در مینیبرنامه یک برنامه بسازید، توکن API آن را یک بار کپی کنید و فراخوانی API را شروع کنید. همهی این تنظیمات زیر بیشتر ← API پذیرنده جمع شده است.
اتصال یک عامل هوش مصنوعی
به عامل کدنویسی هوش مصنوعیتان فقط یک آدرس بدهید — https://app.tgcryptopay.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 میکند.