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