پرداخت رمزارزی در ربات تلگرام: صورت‌حساب، وبهوک و پرداخت به کاربران
API پذیرنده، API پرداخت TgPay Crypto برای ربات‌ها و سرویس‌هاست. برنامه بسازید، توکن بگیرید، از کد خود صورت‌حساب صادر کنید و وبهوک امضاشده پرداخت را دریافت کنید. عامل سازگار با MCP می‌تواند به پیاده‌سازی اتصال کمک کند. پرداخت از موجودی کیف پول داخل سرویس تسویه میشود؛ پرداخت روی بلاکچین تابع قواعد تأیید شبکه انتخابی است.
آدرس پایه API — app.tgpaycrypto.com/pay/api · شبکه آزمایشی — testnet.tgpaycrypto.com
از توکن تا اولین پرداخت در چهار مرحله
روند آشنای API پرداخت: صورت‌حساب بسازید، لینک را نشان دهید و منتظر رویداد بمانید.
برنامه بسازید
در ربات «بیشتر» ← «API پذیرنده» را باز کنید و نام و آدرس وبهوک را وارد کنید. توکن فقط یک بار نمایش داده میشود؛ آن را در سرور خود نگه دارید.
صورت‌حساب بسازید
یک درخواست POST به createInvoice: مبلغ رمزارزی یا فیات، توضیح و مهلت پرداخت. پاسخ شامل لینک پرداخت است.
لینک را به کاربر نشان دهید
یک دکمه یا لینک در ربات شما کافی است تا کاربر با یک لمس از موجودی کیف پول پرداخت کند.
وبهوک را پردازش کنید
سرور شما invoice_paid را با امضای HMAC-SHA256 دریافت میکند. امضا را بررسی کنید، موارد تکراری را با update_id تشخیص دهید و سپس کالا را تحویل دهید.
دستیار هوش مصنوعی شما می‌تواند اتصال را انجام دهد
API پذیرنده سرور MCP دارد. آن را در کلاینت عامل سازگار متصل کنید تا عامل مستندات را بخواند، درخواست ساخت برنامه بدهد، وب‌هوک‌ها را تنظیم کند و به نوشتن کد اتصال کمک کند. شما برنامه را در Telegram تأیید و نتیجه را بررسی و آزمایش می‌کنید.
- مرحله 1
درخواست را برای دستیار بفرستید
از کلاینت عاملی استفاده کنید که پشتیبانی از MCP راه دور برای حساب یا فضای کاری شما در آن فعال است. متن درخواست در برنامه نیز هست: «بیشتر» ← «API پذیرنده» ← اتصال عامل هوش مصنوعی.
- مرحله 2
برنامه را در تلگرام تأیید کنید
دستیار یک لینک t.me میدهد. ربات نشان میدهد چه چیزی درخواست شده و شما با یک دکمه تأیید می‌کنید. لینک یک‌بارمصرف است؛ پیش از تأیید شما چیزی ساخته نمی‌شود.
- مرحله 3
اتصال را تکمیل و آزمایش کنید
عامل توکن محدودی میگیرد و به تنظیم صورتحسابها، طرحهای اشتراک و وب‌هوک‌ها کمک میکند. برای دریافت کلید امضای وبهوک، توکن اصلی را در برنامه دوباره صادر کنید و در محل امنی روی سرور خود نگه دارید.
توکن عامل اجازه دریافت پرداخت و تنظیم وبهوک میدهد، اما انتقال، صدور چک یا بازگشت وجه با آن ممکن نیست. این کارها به توکنی با مجوزهای مربوط نیاز دارند.
جزئیات اتصال دستیار در مستنداتConnect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Crypto Merchant API.
claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
در تنظیمات کلاینت، app.tgpaycrypto.com/mcp را بهعنوان سرور MCP راه دور اضافه کنید. دسترسی به این قابلیت و نام گزینه‌های منو به کلاینت و حساب شما بستگی دارد.
https://testnet.tgpaycrypto.com/mcp
کارمزدها و سقف‌ها
این مقادیر هنگام ساخت صفحه از فهرست عمومی محدودیت‌های برنامه گرفته شده‌اند. مقادیر فعلی را در خود برنامه ببینید.
امکانات API پذیرنده
برنامه موجودی مستقل از کیف پول شما دارد: پرداخت صورتحسابها به آن اضافه میشود و پرداخت به کاربران و چک‌ها از آن کسر میشود.
صورت‌حساب و بازگشت وجه
مبلغ ثابت رمزارزی، قیمت فیات یا مبلغ آزاد به انتخاب پرداخت‌کننده. بازگشت کامل یا بخشی از وجه، حتی برای پرداخت‌کنندگان ناشناس.
اشتراک‌ها
کاربر طرح را یک بار تأیید میکند. پس از آن، مبلغ هر دوره خودکار کسر میشود و برای هر پرداخت رویدادی ارسال میشود.
انتقال و چک
پرداخت به کاربران تلگرام از موجودی برنامه و چک‌ها: لینک‌هایی که هر کسی می‌تواند وجه آن‌ها را دریافت کند.
وب‌هوک‌ها
invoice_paid همیشه ارسال میشود. رویدادهای انقضای صورت‌حساب، دریافت چک، بازگشت وجه و اشتراک را برای هر برنامه جداگانه فعال می‌کنید.
شبکه آزمایشی
همان API و مینیبرنامه در @tgpaycrypto_testnet_bot در دسترس است. با دکمه صفحه اصلی، هر ساعت یک بار رمزارز آزمایشی بگیرید.
دستیار هوش مصنوعی و MCP
app.tgpaycrypto.com/mcp را در کلاینتی که از سرورهای MCP راه دور پشتیبانی میکند متصل کنید. پس از تأیید شما در Telegram، عامل می‌تواند برنامه بسازد و به نوشتن کد اتصال کمک کند. نتیجه را پیش از استفاده بررسی و آزمایش کنید.
سازگار با Crypto Bot API
نام متدهای آشنا، قالب پاسخ {ok, result} و امضای HMAC وبهوک. آدرس API و توکن را بهروز کنید و سپس متدهای مورد استفاده در اتصال خود را آزمایش کنید.
کنترل توکن
توکن با دسترسی محدود، تعویض فوری توکن، پرداخت فقط به کاربران فهرست یا غیرفعال‌کردن پرداخت‌ها، و سقف روزانه پرداخت برای زمانی که توکن افشا شود.
پرسش‌های API
درباره توکن‌ها، امضای وبهوک، آزمایش و مهاجرت از API دیگر.
بسته به سیاست جاری، ساخت برنامه ممکن است به تکمیل احراز هویت نیاز داشته باشد. اگر خطای احراز هویت گرفتید، مراحل را در برنامه کامل کنید و دوباره تلاش کنید.
هدر TgPayCrypto-API-Signature حاوی HMAC-SHA256 بدنه درخواست است و کلید آن SHA-256 توکن اصلی شماست. امضا را با بایت‌های اصلی بدنه مقایسه کنید. تا زمانی که بررسی موفق نشده، کالا را تحویل ندهید و صورت‌حساب را پرداخت‌شده نکنید.
API پذیرنده از نام متدهای آشنا، قالب {ok, result}، مبالغ بهصورت رشته اعشاری و امضای HMAC استفاده میکند. آدرس API و توکن را بهروز کنید؛ هدر 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 را به دستیار هوش مصنوعی بدهید و ساخت برنامه را با یک دکمه تأیید کنید.
باز کردن ربات