API التجّار (للمطورين)
واجهة API للتجّار: التطبيقات والفواتير والتحويلات وروابط الويب هوك.
ما هي واجهة التجار؟
واجهة التجار هي واجهة الدفع البرمجية في التطبيق، موجَّهة إلى الشركات والبوتات. تنشئ تطبيقًا، وتحصل على رمز API، وتستخدمه لتحصيل المدفوعات من مستخدمي تيليجرام وإرسال الأموال إليهم ومتابعة رصيدك — كل ذلك من داخل شيفرتك.
البدء كمطوّر
أنشئ تطبيقًا داخل التطبيق المصغّر، وانسخ رمز API مرة واحدة، وابدأ استدعاء الواجهة. وكل الإعداد يجري في المزيد ← واجهة التجار.
ربط وكيل ذكاء اصطناعي
اربط وكيلًا برمجيًا يدعم خوادم MCP البعيدة بالرابط https://app.tgpaycrypto.com/mcp. يمكنه قراءة وثائق الواجهة، وطلب إنشاء تطبيق تاجر، وضبط الويب هوك، والمساعدة في كتابة التكامل. توافق أنت على إنشاء التطبيق في البوت، ويتلقى الوكيل رمزًا محدود الصلاحيات دون أن تنسخه يدويًا. راجع التكامل واختبره قبل قبول مدفوعات حقيقية.
قبول المدفوعات بالفواتير
الفاتورة هي وسيلتك لتحصيل المال من مستخدم في تيليجرام. تنشئها عبر الواجهة، وترسل رابطها إلى الدافع، فيُضاف المبلغ إلى رصيد تطبيقك بعد نجاح الدفع، مع خصم رسوم التاجر.
رسوم واجهة التجار وحدودها
على الفواتير رسوم منصة تُقتطع مما تستلمه؛ أما التحويلات والشيكات فتحدّها حدود المبالغ. والأرقام أدناه هي الإعدادات الحالية وليست شروطًا تعاقدية — فإذا خالفت ما تراه أمامك، فالصواب ما يعرضه التطبيق، والمصدر الموثوق دائمًا فواتيرك المدفوعة نفسها.
مرجع واجهة التجار
تجمع هذه الصفحة القواعد التي تشترك فيها كل الطرق، ومعها طرق الكتالوج المخصصة للقراءة. وصفحات الطرق تفصيلًا: الفواتير والاسترداد، و التحويلات والشيكات، والاشتراكات، والويب هوك.
مرجع الواجهة: الفواتير والاسترداد
طرق الفواتير: createInvoice و getInvoices و deleteInvoice و refundInvoice. والقواعد المشتركة (المصادقة وبنية الاستجابة والمبالغ و spend_id) في صفحة مرجع واجهة التجار؛ أما الشرح المتدرّج فهو قبول المدفوعات بالفواتير.
مرجع الواجهة: التحويلات والشيكات
طرق صرف الأموال. يرسل التحويل الأموال من رصيد تطبيقك إلى محفظة مستخدم في تيليجرام، أو يحجزها حتى يفتح المستلِم الجديد البوت. أما الشيك فرابط لاستلام مبلغ تموّله مسبقًا. والقواعد المشتركة (المصادقة وبنية الاستجابة والمبالغ و spend_id) في صفحة مرجع واجهة التجار.
مرجع الواجهة: الاشتراكات
تحصيل دوري — وهو ميزة إضافية إلى ما تدعمه واجهة Crypto Bot. تنشئ خطة (مبلغ + فترة)، وترسل إلى المستخدمين رابط الموافقة عليها، فتخصم المنصة المبلغ من رصيد محافظهم في كل فترة، وتضيف إلى رصيد تطبيقك المبلغ بعد خصم الرسوم. والقواعد المشتركة تجدها في صفحة مرجع واجهة التجار.
مرجع الواجهة: الويب هوك
يرسل الويب هوك الأحداث إلى خادمك بعد وقوعها. اضبط رابط الويب هوك (اختياري) لتطبيقك في المزيد ← واجهة التجار؛ عندها ترسل المنصة جسم JSON موقّعًا عبر POST لكل حدث أنت مشترك فيه.
شروط واجهة التجار
تنظّم هذه الشروط استعمال واجهة التجار — التطبيقات ورموز API والفواتير والاشتراكات والتحويلات والشيكات والويب هوك وموصّل وكيل الذكاء الاصطناعي. وهي تسري إضافةً إلى شروط الاستخدام العامة للتطبيق وسياسة AML فيه. وبإنشاء تطبيق فأنت تقبلها؛ وباستمرارك في استعمال تطبيق أُنشئ قبل 7 سبتمبر 2026 فأنت تقبلها كذلك.