واجهة برمجة التطبيقات Web Top-Up API

على الشركات المتعهّدة تنفيذ مضيف ويب لإعادة توجيه المستخدمين بهدف إضافة رصيد. طريقة إضافة الرصيد هذه هي طريقة مختلفة، ولكنها الغرض نفسه من ميزة إضافة الرصيد التي تقدمها ميزة "إضافة الرصيد" على نظام التشغيل Android. يجب أن يكون لدى مضيف الويب هذا موقع إلكتروني متوافق مع الأجهزة الجوّالة.

يجب أن يحدّد مضيف الويب طلبات الويب على الأجهزة الجوّالة في مقابل طلبات الويب على أجهزة الكمبيوتر المكتبي استنادًا إلى قيمة عنوان وكيل المستخدم. يجب أن تكون الصفحة التي يتم عرضها في طلبات الويب على الأجهزة الجوّالة متوافقة مع الويب على الأجهزة الجوّالة على نظامَي التشغيل Android وiOS. بالإضافة إلى قيمة عنوان وكيل المستخدم، لن يقدم لك العميل أي تلميح آخر بشأن البيئة التي يجري فيها هذا المستخدم الطلب (سطح المكتب أو الويب).

يجب أن يستخدم الخادم بروتوكول HTTPS باستخدام GET. يمكن لشركة الدمج تحديد المسار والمضيف. يجب أن تتيح وحدة الدمج طول عناوين URL التي تبلغ 2,048 حرفًا. يتضمن ذلك المخطط والمضيف والمنفذ والمسار والمعلمات.

وسيتمّ ترميز كل المَعلمات بترميز UTF-8 قبل ترميز عنوان URL.

الطلب

تقدِّم Google ما يلي عند الطلب كمَعلمات عناوين URL:

الحقول
gspMajorVersion	int رقم الإصدار الرئيسي لهذا الطلب.
gspTopUpRequest	TopUpRedirectRequest طلب إضافة رصيد.
gspAssociationId	string تحتوي على معرّف تستخدمه جهة الدمج للبحث عن بيانات الاعتماد الخاصة بالحساب الذي يضيفه المستخدم. هذا هو رقم تعريف الربط الذي يتم إرساله أثناء ربط الحساب في AssociateAccountRequest.
gspCallbackUrl	string عنوان URL لإعادة توجيه المستخدم إليه من أجل إنهاء عملية إضافة رصيد على Google. هذه القيمة مرمّزة في عنوان URL.

الإجابة

بعد إكمال عملية إضافة الرصيد، يجب إعادة توجيه المستخدم إلى gspCallbackUrl باستخدام HTTPS GET. يجب أن يحتوي عنوان URL هذا على معلمات طلب البحث التالية:

الحقول
gspResult	int 100 تمت إضافة رصيد بنجاح. 201 ألغى المستخدم المسار يدويًا ويجب إلغاء هذا التدفق. 202 تعذّر إتمام عملية إضافة الرصيد لسبب خطير، وبالتالي يجب إلغاء عملية إضافة الرصيد.
redirectRequestId	string مطلوب: مبلغ requestId الذي تم إرساله في طلب الدفع الأصلي/الذي يتم إعادة التوجيه إليه. ستتحقّق Google من تطابق هذه العملية مع requestId المُرسَلة، وستتعذّر إكمال عملية إعادة التوجيه في حال عدم التطابق.
gspTopUpResponse	RedirectResponse مطلوب: يجب تشفير TopUpRedirectResponse وتوقيعها باستخدام PGP أو JWE+JWS. بالإضافة إلى ذلك، يجب أن تكون هذه القيمة بترميز base64 آمن على الويب.