سولانا Pay هو بروتوكول قياسي ومجموعة من التطبيقات المرجعية التي تمكّن المطورين من دمج المدفوعات اللامركزية في تطبيقاتهم وخدماتهم. يوفر نهجًا موحدًا للمدفوعات عبر النظام البيئي لسولانا، مما يضمن التوافق بين المحافظ والتطبيقات والخدمات.
نظرة عامة على البروتوكول
يحدد سولانا Pay نوعين رئيسيين من طلبات الدفع:
طلبات التحويل (غير التفاعلية)
تصف طلبات التحويل عمليات تحويل بسيطة لعملات SOL أو رموز SPL باستخدام معاملات URL. يمكن للمحفظة إنشاء المعاملة وتوقيعها مباشرة دون الحاجة إلى اتصال إضافي بالخادم.
solana:recipient?amount=1.5&spl-token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
حالات الاستخدام:
- المدفوعات والتبرعات البسيطة
- مدفوعات رمز الاستجابة السريعة في نقاط البيع
- روابط الدفع في رسائل البريد الإلكتروني أو الرسائل
- الربط العميق لتطبيقات الهاتف المحمول
طلبات المعاملات (التفاعلية)
تتيح طلبات المعاملات تفاعلات معقدة من خلال قيام المحفظة بالتواصل مع الخادم لإنشاء أي معاملة على سولانا. وهذا يفتح المجال لحالات استخدام متقدمة تتجاوز التحويلات البسيطة.
solana:https://merchant.com/api/payment
حالات الاستخدام:
- سك الرموز غير القابلة للاستبدال (NFT) في نقطة البيع
- التسعير الديناميكي والخصومات
- معاملات DeFi متعددة الخطوات
- دمج برامج الولاء
- منطق الأعمال المخصص
الفوائد الرئيسية
للمطورين
- بروتوكول قياسي: تطبيق واحد يعمل عبر جميع محافظ سولانا
- مستقل عن الإطار: استخدمه مع أي إطار عمل ويب أو منصة للهاتف المحمول
- أمان الأنواع: دعم كامل لـ TypeScript في JavaScript SDK
- مرن: من التحويلات البسيطة إلى المعاملات متعددة التعليمات المعقدة
للمستخدمين
- سريع: تتم تأكيد المعاملات في أقل من ثانية
- رخيص: متوسط تكلفة 0.0005 دولار لكل معاملة
- آمن: لا وسطاء أو معالجات من طرف ثالث
- عالمي: يعمل مع أي محفظة سولانا
للتجار
- بدون رسوم: مدفوعات مباشرة بدون رسوم معالجة
- الوقت الفعلي: تسوية وتأكيد فوري
- عالمي: استقبال المدفوعات من أي مكان في العالم
- قابل للتركيب: التكامل مع بروتوكولات DeFi وأسواق NFT
البنية التقنية
مخطط URL
يستخدم Solana Pay مخطط URL مخصص solana: يعمل عبر متصفحات الويب وأنظمة تشغيل
الهواتف المحمولة:
- الويب: يمكن استخدام عناوين URL كروابط أو تشفيرها في رموز QR
- الهواتف المحمولة: تكامل الربط العميق مع تطبيقات المحفظة
- سطح المكتب: معالجات البروتوكول لإطلاق المحفظة بسلاسة
حزمة JavaScript SDK
توفر حزمة @solana/pay SDK (المبنية على @solana/kit):
- مصانع العملاء:
createMerchantClient،createWalletClient،createSolanaPayClientلتدفقات دفع قابلة للتركيب - ترميز/تحليل URL:
encodeURL،parseURLلعناوين Solana Pay URL - إنشاء التحويل:
createTransferلتعليمات الدفع بـ SOL ورموز SPL - التحقق من الدفع:
findReference،validateTransfer،watchReferenceللكشف عن المدفوعات والتحقق منها - رموز QR:
createQRمدمج لإنشاء رموز دفع قابلة للمسح - إضافات Kit:
solanaPayMerchant()،solanaPayWallet()للتركيب مع إضافات@solana/kitأخرى
تكامل المحفظة
المحافظ الداعمة تنفذ:
- معالجة وتحليل مخطط URL
- تكوين المعاملات والتحقق منها
- تدفقات تأكيد المستخدم
- بث المعاملات ومراقبتها
أمثلة على تدفق الدفع
من تطبيق الويب إلى محفظة الهاتف المحمول
- ينشئ تطبيق الويب رمز QR مع عنوان Solana Pay URL
- يقوم المستخدم بمسح رمز QR باستخدام تطبيق المحفظة
- تقوم المحفظة بتحليل عنوان URL وعرض تفاصيل الدفع
- يؤكد المستخدم الدفع في المحفظة
- توقع المحفظة المعاملة وتبثها
- يكتشف تطبيق الويب تأكيد الدفع
من تطبيق الويب إلى محفظة المتصفح
- يعرض تطبيق الويب زر "الدفع باستخدام سولانا"
- ينقر المستخدم على الزر لتشغيل المحفظة
- تعرض إضافة المحفظة تأكيد الدفع
- يوافق المستخدم على المعاملة
- يتم توقيع المعاملة وإرسالها
- يستقبل تطبيق الويب تأكيد الدفع
من تطبيق الجوال إلى محفظة الجوال
- يقوم تطبيق الجوال بإنشاء رابط دفع عميق
- يقوم الرابط العميق بتشغيل تطبيق المحفظة
- تعرض المحفظة تأكيد الدفع
- يوافق المستخدم على الدفع أو يرفضه
- تعود المحفظة إلى التطبيق الأصلي
- يتلقى التطبيق نتيجة الدفع
اعتبارات الأمان
للتجار
- التحقق من المعاملات: تحقق دائماً من تفاصيل المعاملة على السلسلة
- استخدام المراجع: قم بتضمين مفاتيح مرجعية فريدة لتحديد المدفوعات
- التحقق من جانب الخادم: احسب المبالغ وتحقق من المدفوعات من جانب الخادم
- الحد من المعدل: قم بتطبيق حدود معدل مناسبة على نقاط نهاية الدفع
لمطوري المحفظة
- التحقق من عنوان URL: تحقق من صحة جميع مكونات عنوان URL وقم بتعقيمها
- تأكيد المستخدم: اعرض دائماً تفاصيل الدفع بوضوح للمستخدمين
- التحقق من المعاملة: تحقق من محتويات المعاملة قبل التوقيع
- HTTPS فقط: اسمح فقط بعناوين URL من نوع HTTPS لطلبات المعاملات
أنماط التكامل
الدفع في التجارة الإلكترونية
- يضيف العميل العناصر إلى سلة التسوق
- يقوم التاجر بإنشاء طلب دفع مع تفاصيل الطلب
- يقوم العميل بمسح رمز QR أو النقر على زر الدفع
- تعرض المحفظة إيصالاً مفصلاً والمبلغ الإجمالي
- يؤكد العميل الدفع
- يتحقق التاجر من المعاملة ويُنفذ الطلب
نقطة البيع
- يُدخل أمين الصندوق مبلغ البيع
- يعرض نظام نقطة البيع رمز QR
- يقوم العميل بالمسح باستخدام محفظة الجوال
- تتم معالجة الدفع فوراً
- تتم طباعة الإيصال تلقائياً
خدمات الاشتراك
- يشترك المستخدم في الخدمة
- تُنشئ الخدمة جدولاً للدفع المتكرر
- يقوم النظام الآلي بإنشاء طلبات الدفع
- يوافق المستخدم على المدفوعات من خلال المحفظة
- تتبع الخدمة حالة الدفع
أفضل الممارسات
إنشاء عنوان URL
- استخدم HTTPS لجميع نقاط نهاية طلبات المعاملات
- قم بتضمين تسميات ورسائل وصفية
- أنشئ مراجع فريدة لتتبع الدفع
- تحقق من صحة جميع المعاملات قبل إنشاء عنوان URL
معالجة المعاملات
- تحقق دائمًا من صحة المعاملات من جانب الخادم
- استخدم عدد التأكيدات المناسب للأمان
- نفذ معالجة الأخطاء وإعادة المحاولات بشكل صحيح
- سجل أحداث الدفع للتسوية
تجربة المستخدم
- قدم تأكيدات دفع واضحة
- اعرض تحديثات حالة المعاملات
- تعامل مع اتصال المحفظة بسلاسة
- ادعم خيارات محافظ متعددة
الخطوات التالية
هل أنت مستعد لدمج Solana Pay؟ ابدأ بهذه الأدلة:
- دليل التثبيت - إعداد SDK والأدوات
- طلبات التحويل - إنشاء روابط دفع بسيطة
- طلبات المعاملات - بناء تدفقات تفاعلية
- أمثلة التكامل - شاهد التطبيقات الواقعية
الموارد
- المواصفات الرسمية - مواصفات البروتوكول الكاملة
- مستودع GitHub - الكود المصدري والأمثلة
- إرشادات العلامة التجارية - الشعارات وأصول العلامة التجارية
Is this page helpful?