API پذیرنده چیست؟
API پذیرنده رابط برنامه‌نویسی پرداخت این برنامه برای کسب‌وکارها و ربات‌هاست. یک برنامه‌ی پذیرنده می‌سازید، توکن API آن را می‌گیرید و با همان توکن، از کد خودتان، برای کاربران تلگرام صورت‌حساب صادر می‌کنید، برایشان دارایی می‌فرستید و موجودی‌تان را می‌خوانید.
این همان محصولی است که کاربران می‌بینند، اما از سمت توسعه‌دهنده: صورت‌حسابی که با API می‌سازید، همان صورت‌حسابی است که کاربر پس از تأیید پرداخت از موجودی خودش پرداخت می‌کند.
با آن چه کارهایی می‌توان کرد
- صورت‌حساب‌ها — یک درخواست پرداخت بسازید (مبلغی ثابت به رمزارز، مبلغی به ارز فیات یا مبلغ دلخواهی که خود پرداخت‌کننده وارد می‌کند)، لینک آن را برای پرداخت‌کننده بفرستید و پس از پرداخت، در صورت تنظیم آدرس وب‌هوک، یک وب‌هوک امضاشده بگیرید.
- بازگشت وجه — مبلغ یک صورت‌حساب پرداخت‌شده را، کامل یا بخشی از آن، به همان کسی که پرداخت کرده برگردانید — حتی اگر ناشناس پرداخت کرده باشد.
- انتقال — از موجودی برنامه‌تان به یک کاربر تلگرام رمزارز بفرستید، یکی‌یکی یا تا 100 مورد در یک دسته.
- چک‌ها — از موجودی برنامه لینک‌های دریافت دارایی برای همه یا گیرندگان مشخص بسازید؛ تنظیمات پرداخت برنامه بر آن‌ها اعمال می‌شود.
- اشتراک‌ها — صورت‌حساب دوره‌ای: کاربر یک بار طرح را تأیید می‌کند و از آن به بعد هر دوره به‌صورت خودکار از او کسر می‌شود.
- موجودی، ارزها، نرخ تبدیل و آمار — متدهای فقط خواندنی برای حسابداری خودتان.
اجزا چطور به هم وصل می‌شوند
- هر برنامه موجودی خودش را دارد، جدا از کیف پول شخصی شما.
- صورت‌حساب‌هایی که کاربران پرداخت می‌کنند به موجودی همان برنامه افزوده می‌شوند.
- انتقال‌ها و چک‌ها از همان موجودی برداشته می‌شوند.
- با تنظیم آدرس و انتخاب رویدادها، رویدادهای پرداخت پشتیبانی‌شده می‌توانند به‌صورت یک وب‌هوک امضاشده به سرور شما فرستاده شوند.
پرداخت‌ها داخل خود برنامه تسویه می‌شوند، نه روی زنجیره: نه کارمزد شبکه‌ای در کار
است، نه انتظاری برای تأیید شبکه و دارایی همان لحظه که می‌رسد قابل استفاده است.
اگر گزینه پرداخت از کیف پول بیرونی در دسترس باشد، پرداخت‌کننده می‌تواند از آن برای تأمین موجودی استفاده کند. واریز به کیف پول خود او می‌رود؛ پرداخت خودکار به موجودی کافی، نبود محدودیت خروج دارایی و باقی بودن مهلت پرداخت هم نیاز دارد. پیش از تحویل سفارش، مطمئن شوید وضعیت صورت‌حساب paid است.
سازگار با Crypto Bot
این API عمداً همان شکل Crypto Bot را دارد: همان نام متدها، همان قالب
{ok, result}، همان مبلغ‌های رشته‌ای اعشاری، همان روش امضای وب‌هوک. برای سازگار کردن یک
یکپارچه‌سازی موجود، آدرس پایه و توکن را عوض کنید و سپس متدهای مورد استفاده را با مرجع ما آزمایش کنید. مانند Crypto Bot، ما هم یک
شبکه‌ی آزمایشی با ربات و آدرس پایه‌ی جداگانه
داریم.
هدر رسمی توکن TgPayCrypto-API-Token است؛ TgCryptoPay-API-Token (نام پیش از
2026-09-07) همچنان کار می‌کند و Crypto-Pay-API-Token هم به‌عنوان نام
جایگزین پذیرفته می‌شود تا کتابخانه‌های کلاینت موجود بدون تغییر کار کنند.
⚠️ توکن API شما کلید دسترسی به موجودی است
توکن اصلی در چارچوب حالت پرداخت و سقف‌های برنامه اجازه پرداخت می‌دهد. آن را سمت سرور نگه دارید، بیرون از برنامه‌های کلاینت و مخزن‌های کد و به‌محض اینکه به نشت آن شک کردید آن را تعویض کنید. برای سرورهایی که به دسترسی کامل نیاز ندارند یک توکن محدود بسازید که فقط به همان دامنه‌های دسترسی موردنیازشان محدود باشد — مرجع API را ببینید.
در ادامه
آیا این مطلب برای شما مفید بود؟
از بازخوردتان ممنونیم.