يتيح لك برنامج عمليات الدفع الخارجية توجيه المستخدمين في اليابان إلى الميزات أو الخدمات الرقمية داخل تطبيقك والتي يمكن شراؤها خارج تطبيقاتك، بما في ذلك من خلال روابط الدفع الخارجية. عند توجيه المستخدمين إلى عمليات الشراء، يجب أن يُتاح لهم خيار إجراء عملية الشراء باستخدام نظام الفوترة في Google Play أو إكمالها على الموقع الإلكتروني الخاص بالمطوّر. يتناول هذا الدليل واجهات برمجة التطبيقات المطلوبة لتفعيل عمليات الدفع الخارجية. لمزيد من التفاصيل، راجِع متطلبات البرنامج.
مسرد المصطلحات
اتّبِع اصطلاحات المصطلحات التالية في هذا الدليل:
- واجهات برمجة التطبيقات لعمليات الدفع الخارجية: هي واجهات برمجة تطبيقات تُستخدَم لتوجيه المستخدم إلى خارج التطبيق لشراء سلع رقمية داخل التطبيق.
- المعاملة الخارجية: هي معاملة مؤهَّلة تتم خارج التطبيق وفقًا لمتطلبات البرنامج.
- رمز المعاملة الخارجية: هو رمز يتم تقديمه إلى المطوّر من خلال مكتبة الفوترة في Play لتستخدمه عندما يكمل المستخدم معاملة خارجية. يُستخدم هذا الرمز المميز لإعلام Google Play بأنّ عملية الشراء قد تمت بنجاح.
- معرّف المعاملة الخارجية: هو معرّف فريد تنشئه لتحديد معاملة خارجية.
السماح بعمليات الدفع الخارجية
إذا أردت تضمين عمليات الدفع الخارجية في تطبيقك، عليك استيفاء المعايير التالية:
- راجِع متطلبات الأهلية لاستخدام عمليات الدفع الخارجية وأكمِل خطوات التسجيل الموضّحة في متطلبات البرنامج.
- دمج الإصدار 8.3 أو إصدار أحدث من Play Billing Library
الإعداد في Play Console
لضبط نظام الدفعات الخارجية في Play Console، اتّبِع الخطوات الموضّحة في متطلبات البرنامج.
تجربة المستخدم
تتيح واجهات برمجة التطبيقات من جهة العميل الوظائف التالية:
- يعرض Google Play شاشات المعلومات وخيارات المستخدمين ذات الصلة ويديرها.
- إذا اختار المستخدم استخدام نظام الفوترة في Google Play، سيستمر مسار الفوترة باستخدام واجهة نظام الفوترة العادية في Google Play.
- إذا اختار المستخدم نظام الفوترة الخاص بك، سيتم توجيهه إلى موقع إلكتروني خارجي أو تطبيق دفع مثبَّت مسبقًا على جهاز المستخدم. يمكنك تحديد ما إذا كان Google Play أو تطبيقك سيوجهان المستخدم إلى الموقع الإلكتروني.
شاشة اختيار الفوترة |
صفحة إعادة التوجيه |
الموقع الإلكتروني للمطوّر |
مثال لأغراض توضيحية فقط.
شاشة اختيار المستخدم
تعرض شاشة اختيار نظام الفوترة للمستخدمين خيار استخدام نظام الفوترة الخاص بالمطوّر أو نظام الفوترة في Google Play.
شرح تفصيلي لخيار الدفع الخارجي
يتضمّن خيار الدفع الخارجي على شاشة "الفوترة حسب اختيار المستخدم" عناصر واجهة المستخدم التالية:
- رمز التطبيق
- اسم التطبيق
- مادة عرض على شكل صورة تتضمّن طُرق الدفع التي يوفّرها المطوّر
- مؤشر إضافي (عنصر واجهة المستخدم والمزيد ليس جزءًا من مادة عرض الصورة).
مادة عرض الصورة لطرق الدفع
تتكوّن مادة عرض الصورة الفردية من بطاقات متعددة لطرق الدفع ويجب أن تتوافق مع المواصفات المحدّدة في هذه الإرشادات.
الأبعاد |
192dp × 20dp |
تباعُد البطاقات |
8dp |
تنسيق الملف |
ملف PNG بخلفية شفافة |
اختلافات طرق الدفع
يمكن للمطوّرين اختيار عدد رموز طرق الدفع المتاحة التي يريدون تضمينها في مادة عرض الصورة، بما لا يزيد عن 5 رموز.
يجب ألا تتضمّن الصورة أي صور أو نصوص أخرى.
مواصفات البطاقة
يجب أن تتّبع بطاقات طريقة الدفع المضمّنة في مادة عرض الصورة الإرشادات التالية بشأن الحجم والمسافة والأسلوب.
| أبعاد البطاقة | 32 وحدة بكسل مستقلة عن الكثافة × 20 وحدة بكسل مستقلة عن الكثافة |
| المساحة المتروكة الداخلية | 3dp |
| المخطَّط | 1dp (يتم تضمين الحد الداخلي في الأبعاد)، نصف القطر 2dp، #E0E0E0 |
| خلفية البطاقة | لون خالص (يُفضّل الأبيض) |
الخطوات التالية
لبدء دمج واجهات برمجة التطبيقات لعمليات الدفع الخارجية، اتّبِع الأدلة التفصيلية لكل من عملية الدمج داخل التطبيق وعملية الدمج في الخلفية.