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