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