مدفوعات العملات الرقمية في بوت تيليجرام: فواتير وwebhooks ومدفوعات للمستخدمين
واجهة التجار هي API المدفوعات من TG Crypto Pay للبوتات والخدمات. أنشئ تطبيقًا في البوت، واحصل على توكن، وأصدر الفواتير من الكود، وتلقَّ webhook موقّعًا فور الدفع. أو أعطِ عنوان خادم MCP لمساعدك ليتولى التكامل. تُسوّى المدفوعات داخل المحفظة بلا رسوم شبكة أو انتظار للتأكيدات.
عنوان API الأساسي — app.tgpaycrypto.com/pay/api · شبكة الاختبار — testnet.tgpaycrypto.com
من التوكن إلى أول دفعة في أربع خطوات
الخطوات المعتادة لأي API للمدفوعات: أنشئ فاتورة، واعرض الرابط، وانتظر الحدث.
أنشئ تطبيقًا
في البوت، افتح «المزيد» ← «واجهة التجار»، وأدخل الاسم وعنوان URL للـwebhook. يظهر التوكن مرة واحدة فقط؛ احفظه على خادمك.
أنشئ فاتورة
طلب POST واحد إلى createInvoice: مبلغ بالعملة الرقمية أو النقدية، ووصف، وموعد انتهاء. تتضمن الاستجابة رابط الدفع.
اعرض الرابط للمستخدم
زر أو رابط في بوتك: يدفع المستخدم من رصيد المحفظة بلمسة واحدة.
عالِج إشعار ويب هوك
يستقبل خادمك invoice_paid بتوقيع HMAC-SHA256. تحقّق من التوقيع، واستبعد التكرار باستخدام update_id، ثم سلّم المنتج.
يمكن لمساعدك إنجاز التكامل
لواجهة التجار خادم MCP. أعطِ المساعد عنوانًا واحدًا ليقرأ التوثيق وينشئ التطبيق ويضبط webhook ويكتب الكود. لا تحتاج إلى الطرفية أو نسخ التوكن يدويًا.
- الخطوة 1
أرسل التعليمات إلى المساعد
في أي محادثة مع مساعد: Claude Code أو claude.ai أو Claude Desktop أو ChatGPT أو عميل MCP آخر. التعليمات نفسها موجودة في التطبيق عبر «المزيد» ← «واجهة التجار» ← خيار ربط مساعد ذكاء اصطناعي.
- الخطوة 2
وافق على التطبيق في تيليجرام
يعطيك المساعد رابط t.me؛ يعرض البوت الطلب وتوافق بزر واحد. الرابط للاستخدام مرة واحدة، ولا يُنشأ شيء قبل موافقتك.
- الخطوة 3
يكمل المساعد الإعداد بنفسه
يحصل على توكن محدود ويكمل تكامل الفواتير وخطط الاشتراك وwebhook. يبقى مفتاح توقيع webhook معك في التطبيق.
يستطيع توكن المساعد قبول المدفوعات وضبط webhook، لكنه لا يتيح التحويل أو إصدار الشيكات أو الاسترداد. إخراج الأموال يبقى بيدك، باستخدام التوكن الكامل في التطبيق.
تفاصيل ربط المساعد في التوثيق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
الرسوم والحدود
أُخذت القيم من دليل حدود التطبيق العام عند إنشاء هذه الصفحة. القيم الحالية موجودة في التطبيق نفسه.
ما الذي تقدّمه واجهة التجار
للتطبيق رصيد مستقل عن محفظتك: تُضاف إليه مدفوعات الفواتير وتُخصم منه المدفوعات للمستخدمين والشيكات.
الفواتير والاستردادات
مبلغ ثابت بعملة رقمية، أو سعر بعملة نقدية، أو مبلغ مفتوح يحدده الدافع. استرداد كامل أو جزئي، حتى للدافعين المجهولين.
الاشتراكات
يوافق المستخدم على الخطة مرة واحدة، ثم تُحصّل الدفعة تلقائيًا كل فترة، مع حدث لكل دفعة.
التحويلات والشيكات
مدفوعات إلى مستخدمي تيليجرام من رصيد التطبيق، وشيكات على شكل روابط يمكن لأي شخص استلامها.
Webhooks
يُرسل invoice_paid دائمًا. أما أحداث انتهاء الفاتورة واستلام الشيك والاسترداد والاشتراك، فتفعّلها لكل تطبيق على حدة.
شبكة الاختبار
نفس API والتطبيق المصغّر في @tgpaycrypto_testnet_bot. يمنحك زر الشاشة الرئيسية عملات اختبار مرة كل ساعة.
مساعد ذكاء اصطناعي وMCP
أعطِ المساعد app.tgpaycrypto.com/mcp لينشئ التطبيق ويضبط webhook ويكتب التكامل. توافق على التطبيق بزر واحد في البوت.
متوافق مع Crypto Bot API
نفس أسماء الطرق وتنسيق الاستجابة {ok, result} وآلية توقيع webhook. غيّر العنوان الأساسي والتوكن؛ يبقى الكود كما هو.
التوكن تحت سيطرتك
توكنات بصلاحيات محدودة، وتدوير فوري، ووضع مدفوعات للمستخدمين المدرجين فقط أو تعطيلها كليًا، وحد يومي للمدفوعات في حال تسرّب التوكن.
أسئلة عن API
عن التوكنات وتوقيع webhook والاختبار والانتقال من API آخر.
قد يتطلب إنشاء تطبيق إكمال التحقق من الهوية حسب السياسة الحالية. إذا ظهر خطأ متعلق بالتحقق، أكمل الخطوات في التطبيق ثم حاول مجددًا.
يحمل الترويسة TgPayCrypto-API-Signature قيمة HMAC-SHA256 لجسم الطلب، بمفتاح هو SHA-256 للتوكن الرئيسي. قارن التوقيع باستخدام البايتات الأصلية للجسم. لا تسلّم المنتج ولا تسجّل الفاتورة كمدفوعة حتى ينجح التحقق.
نعم. تطابق واجهة التجار طرق 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 مرة كل ساعة. توكنات الشبكة الرئيسية والاختبار لا تعمل إحداها بدل الأخرى.
يحصل المساعد على توكن محدود: ينشئ الفواتير وخطط الاشتراك، ويقرأ الرصيد والإحصاءات، ويضبط عنوان webhook. التحويلات والشيكات والاستردادات تتطلب التوكن الكامل الذي يبقى معك.
التوثيق العام لواجهة التجار
مرجع الطرق ووصف OpenAPI والأدلة التفصيلية على docs.tgpaycrypto.com.
اربط المدفوعات في أمسية واحدة
أنشئ تطبيقًا في @tgpaycryptobot، أو أعطِ مساعدك رابط خادم MCP ووافق على التطبيق بزر واحد.
فتح البوت