ما هي واجهة التجار؟
واجهة التجار هي واجهة الدفع البرمجية في التطبيق، موجَّهة إلى الشركات والبوتات. تنشئ تطبيقًا، وتحصل على رمز API، وتستخدمه لتحصيل المدفوعات من مستخدمي تيليجرام وإرسال الأموال إليهم ومتابعة رصيدك — كل ذلك من داخل شيفرتك.
وهي الوجه البرمجي للمنتج نفسه الذي يراه المستخدمون: فالفاتورة التي تنشئها عبر الواجهة هي الفاتورة التي يدفعونها من رصيدهم بعد تأكيد الدفع.
ما تتيحه لك الواجهة
- الفواتير — أنشئ طلب دفع (بمبلغ ثابت بالعملات الرقمية، أو بسعر بعملة ورقية، أو بمبلغ مفتوح يختاره الدافع)، وأرسل رابطه إلى الدافع، واستقبل إشعارًا عبر ويب هوك موقّع بعد الدفع إذا أعددت رابط ويب هوك.
- الاسترداد — أعِد مبلغ فاتورة مدفوعة، كاملًا أو جزءًا منه، إلى من دفعها — بمن فيهم من دفع دون كشف هويته.
- التحويلات — أرسل العملات الرقمية من رصيد تطبيقك إلى أي مستخدم في تيليجرام، واحدًا تلو الآخر أو حتى 100 تحويل في دفعة واحدة.
- الشيكات — موّل من رصيد تطبيقك روابط للاستلام، متاحة للجميع أو لمستلمين محددين، بحسب إعدادات المدفوعات الصادرة.
- الاشتراكات — تحصيل دوري: يوافق المستخدم على الخطة مرة واحدة، ثم يُخصم منه المبلغ تلقائيًا في كل فترة.
- الأرصدة والعملات وأسعار الصرف والإحصاءات — طرق للقراءة فقط تخدم دفاترك المحاسبية.
كيف تترابط الأجزاء
- تطبيقك يملك رصيدًا مستقلًا عن محفظتك الشخصية.
- الفواتير التي يدفعها المستخدمون تُضاف إلى رصيد التطبيق.
- والتحويلات والشيكات تُصرف منه.
- يمكن إرسال أحداث الدفع المدعومة إلى خادمك على هيئة ويب هوك موقّع عند ضبط الرابط والاشتراك في الأحداث.
تُسوَّى المدفوعات داخل التطبيق لا على الشبكة: بلا رسوم شبكة، وبلا تأكيدات
تنتظرها، والأموال صالحة للاستخدام لحظة وصولها. ويستطيع الدافع مع ذلك تمويل
الفاتورة من محفظة خارجية عندما يتوفر هذا الخيار. يُضاف الإيداع إلى محفظته؛ ويتطلب الدفع التلقائي أيضًا رصيدًا كافيًا وعدم وجود قيد على العمليات الصادرة وبقاء مهلة الدفع سارية. تحقّق من أن حالة الفاتورة paid قبل تنفيذ الطلب.
متوافقة مع Crypto Bot
صُممت الواجهة عمدًا على غرار واجهة Crypto Bot: أسماء الطرق نفسها، والغلاف
{ok, result} نفسه، والمبالغ نفسها كسلاسل عشرية، وآلية توقيع الويب هوك نفسها.
لتكييف تكامل قائم، غيّر العنوان الأساسي والرمز، ثم اختبر الطرق التي تستخدمها بالرجوع إلى مرجعنا. وكما لدى Crypto Bot، لدينا
شبكة تجريبية ببوت وعنوان أساسي منفصلين.
والترويسة المعتمدة للرمز هي TgPayCrypto-API-Token؛ ولا يزال الاسم السابق
TgCryptoPay-API-Token، المستعمل قبل 2026-09-07، يعمل؛ وتُقبل
Crypto-Pay-API-Token اسمًا بديلًا حتى تبقى مكتبات العملاء القائمة عاملة دون
تعديل.
⚠️ رمز API مفتاح إنفاق
يخوّل الرمز الرئيسي المدفوعات الصادرة ضمن وضع الدفع وحدود التطبيق. احتفظ به على خادمك، بعيدًا عن تطبيقات المستخدمين والمستودعات، وبادر بتدويره فور شكّك في تسربه. أما الخوادم التي لا تحتاج وصولًا كاملًا فأصدر لها رمزًا محدود الصلاحيات مقصورًا على ما تستعمله فعلًا — راجع مرجع الواجهة.
اقرأ بعد ذلك
هل كان هذا المقال مفيدًا؟
شكرًا على ملاحظتك.