پرداخت رمزارزی در ربات تلگرام: صورتحساب، وبهوک و پرداخت به کاربران
API پذیرنده، API پرداخت TG Crypto Pay برای رباتها و سرویسهاست. در ربات برنامه بسازید، توکن بگیرید، از کد خود صورتحساب صادر کنید و بلافاصله پس از پرداخت وبهوک امضاشده بگیرید. یا آدرس سرور MCP را به دستیار هوش مصنوعی بدهید تا اتصال را انجام دهد. پرداخت داخل کیف پول تسویه میشود؛ بدون کارمزد شبکه و انتظار برای تأیید.
آدرس پایه API — app.tgpaycrypto.com/pay/api · شبکه آزمایشی — testnet.tgpaycrypto.com
از توکن تا اولین پرداخت در چهار مرحله
روند آشنای API پرداخت: صورتحساب بسازید، لینک را نشان دهید و منتظر رویداد بمانید.
برنامه بسازید
در ربات «بیشتر» ← «API پذیرنده» را باز کنید و نام و آدرس وبهوک را وارد کنید. توکن فقط یک بار نمایش داده میشود؛ آن را در سرور خود نگه دارید.
صورتحساب بسازید
یک درخواست POST به createInvoice: مبلغ رمزارزی یا فیات، توضیح و مهلت پرداخت. پاسخ شامل لینک پرداخت است.
لینک را به کاربر نشان دهید
یک دکمه یا لینک در ربات شما کافی است تا کاربر با یک لمس از موجودی کیف پول پرداخت کند.
وبهوک را پردازش کنید
سرور شما invoice_paid را با امضای HMAC-SHA256 دریافت میکند. امضا را بررسی کنید، موارد تکراری را با update_id تشخیص دهید و سپس کالا را تحویل دهید.
دستیار هوش مصنوعی شما میتواند اتصال را انجام دهد
API پذیرنده سرور MCP دارد. یک آدرس به دستیار بدهید تا مستندات را بخواند، برنامه بسازد، وبهوک را تنظیم کند و کد بنویسد. نه ترمینال لازم است، نه کپی دستی توکن.
- مرحله 1
درخواست را برای دستیار بفرستید
در هر گفتوگو با دستیار: Claude Code، claude.ai، Claude Desktop، ChatGPT یا کلاینت MCP دیگر. همین درخواست در برنامه نیز هست: «بیشتر» ← «API پذیرنده» ← بخش اتصال دستیار هوش مصنوعی.
- مرحله 2
برنامه را در تلگرام تأیید کنید
دستیار یک لینک t.me میدهد. ربات نشان میدهد چه چیزی درخواست شده و شما با یک دکمه تأیید میکنید. لینک یکبارمصرف است؛ پیش از تأیید شما چیزی ساخته نمیشود.
- مرحله 3
دستیار تنظیمات را کامل میکند
توکن محدودی میگیرد و اتصال صورتحسابها، طرحهای اشتراک و وبهوک را کامل میکند. کلید امضای وبهوک در برنامه نزد شما میماند.
توکن دستیار میتواند پرداخت دریافت کند و وبهوک را تنظیم کند، اما انتقال، صدور چک و بازگشت وجه نمیکند. خروج وجه با توکن کامل در برنامه تحت کنترل شماست.
جزئیات اتصال دستیار در مستنداتConnect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Merchant API.
claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
در تنظیمات اتصالها، اتصال سفارشی اضافه کنید و app.tgpaycrypto.com/mcp را وارد کنید
https://testnet.tgpaycrypto.com/mcp
کارمزدها و سقفها
این مقادیر هنگام ساخت صفحه از فهرست عمومی محدودیتهای برنامه گرفته شدهاند. مقادیر فعلی را در خود برنامه ببینید.
امکانات API پذیرنده
برنامه موجودی مستقل از کیف پول شما دارد: پرداخت صورتحسابها به آن اضافه میشود و پرداخت به کاربران و چکها از آن کسر میشود.
صورتحساب و بازگشت وجه
مبلغ ثابت رمزارزی، قیمت فیات یا مبلغ آزاد به انتخاب پرداختکننده. بازگشت کامل یا بخشی از وجه، حتی برای پرداختکنندگان ناشناس.
اشتراکها
کاربر طرح را یک بار تأیید میکند. پس از آن، مبلغ هر دوره خودکار کسر میشود و برای هر پرداخت رویدادی ارسال میشود.
انتقال و چک
پرداخت به کاربران تلگرام از موجودی برنامه و چکها: لینکهایی که هر کسی میتواند وجه آنها را دریافت کند.
وبهوکها
invoice_paid همیشه ارسال میشود. رویدادهای انقضای صورتحساب، دریافت چک، بازگشت وجه و اشتراک را برای هر برنامه جداگانه فعال میکنید.
شبکه آزمایشی
همان API و مینیبرنامه در @tgpaycrypto_testnet_bot در دسترس است. با دکمه صفحه اصلی، هر ساعت یک بار رمزارز آزمایشی بگیرید.
دستیار هوش مصنوعی و MCP
آدرس app.tgpaycrypto.com/mcp را به دستیار بدهید تا برنامه بسازد، وبهوک را تنظیم کند و کد اتصال را بنویسد. شما برنامه را با یک دکمه در ربات تأیید میکنید.
سازگار با Crypto Bot API
نام متدها، قالب پاسخ {ok, result} و روش امضای وبهوک همان است. آدرس پایه و توکن را عوض کنید؛ کد باقی میماند.
کنترل توکن
توکن با دسترسی محدود، تعویض فوری توکن، پرداخت فقط به کاربران فهرست یا غیرفعالکردن پرداختها، و سقف روزانه پرداخت برای زمانی که توکن افشا شود.
پرسشهای API
درباره توکنها، امضای وبهوک، آزمایش و مهاجرت از API دیگر.
بسته به سیاست جاری، ساخت برنامه ممکن است به تکمیل احراز هویت نیاز داشته باشد. اگر خطای احراز هویت گرفتید، مراحل را در برنامه کامل کنید و دوباره تلاش کنید.
هدر TgPayCrypto-API-Signature حاوی HMAC-SHA256 بدنه درخواست است و کلید آن SHA-256 توکن اصلی شماست. امضا را با بایتهای اصلی بدنه مقایسه کنید. تا زمانی که بررسی موفق نشده، کالا را تحویل ندهید و صورتحساب را پرداختشده نکنید.
بله. API پذیرنده همان متدهای Crypto Bot API، قالب {ok, result}، مبالغ بهصورت رشته اعشاری و روش امضا را دارد. آدرس پایه و توکن را عوض کنید؛ هدر Crypto-Pay-API-Token نیز بهعنوان نام جایگزین پذیرفته میشود.
شبکه آزمایشی همان API و مینیبرنامه را دارد: ربات @tgpaycrypto_testnet_bot و آدرس پایه testnet.tgpaycrypto.com/pay/api. دکمه دریافت رمزارز آزمایشی در صفحه اصلی، هر ساعت یک بار 1,000 USDT، 1,000 GRAM و 0.01 BTC میدهد. توکنهای شبکه اصلی و آزمایشی بهجای هم کار نمیکنند.
دستیار توکن محدودی میگیرد: صورتحساب و طرح اشتراک میسازد، موجودی و آمار را میخواند و آدرس وبهوک را تنظیم میکند. انتقال، صدور چک و بازگشت وجه به توکن کامل نیاز دارد که نزد شما میماند.
مستندات عمومی API پذیرنده
مرجع متدها، شرح OpenAPI و راهنماهای گامبهگام در docs.tgpaycrypto.com.
پرداختها را در یک عصر راهاندازی کنید
در @tgpaycryptobot برنامه بسازید یا لینک سرور MCP را به دستیار هوش مصنوعی بدهید و ساخت برنامه را با یک دکمه تأیید کنید.
باز کردن ربات