ملاحظات إصدار واجهة برمجة التطبيقات

تعرض هذه الصفحة التغييرات الرئيسية في كل إصدار من Google Pay API لنظام Android. يتم ترتيب ملاحظات الإصدار وتحديدها حسب التاريخ، وتتضمّن أوصافًا للتغييرات.

مارس 2026

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

نوفمبر 2025

• تمت إضافة الخيار FULL-ISO3166 إلى السمة format في العنصر BillingAddressParameters، وتمت إضافة سمة format جديدة إلى العنصر ShippingAddressParameters. تم تعديل السمات التي يتم عرضها للعنصرَين IntermediateAddress وAddress لتضمين سمة `format` جديدة. iso3166AdministrativeArea. يجب ألا يؤثر هذا التغيير في عمليات التنفيذ الحالية. يمكنك الاطّلاع على الصفحات المرجعية لمزيد من المعلومات.

أكتوبر 2025

يضبط الإصدار 19.5.0 من مكتبة خدمات Play Wallet الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) على 23 ويتضمّن تعديلات على الاعتماديات الداخلية.

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

• تمت إضافة دعم لأنواع الأزرار الجديدة `PIX` و `EWALLET` إلى Pay Button API

الإصدار التجريبي المغلق

• تمت إضافة طريقة واجهة برمجة التطبيقات الجديدة getPaymentMetdata لجلب البيانات الوصفية المرتبطة بطريقة الدفع المفضّلة لدى المستخدم لتحسين تجربته قبل إتمام الدفع. يُرجى التواصل معنا لمزيد من المعلومات حول هذه الميزة.

يوليو 2024

توفر الآن PayButton API ميزة تخصيص تعرض شبكة بطاقة المستخدم (مثل Visa أو Mastercard) وآخر أربعة أرقام من بطاقته على أزرار الدفع التالية في Google Pay:

نوع الزر	قبل	بعد
الشراء
الدفع

لا يتوفّر هذا التحسين إلا للمستخدمين الذين لديهم بطاقة مؤهّلة مرتبطة بحسابهم على Google Pay.

مايو 2024

يضبط الإصدار 19.4.0 من مكتبة Play Services Wallet الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) على 21 ويتضمّن تعديلات على التبعيات الداخلية.

فبراير 2024

يؤدي هذا الإصدار إلى إيقاف الطريقة AutoResolveHelper#resolveTask(Task, Activity, int) نهائيًا. يُرجى استخدام عقود Activity Result API الجديدة التي تم طرحها في هذا الإصدار بدلاً من ذلك.

تم إصدار الإصدار 19.3.0 من مكتبة Play Services Wallet، الذي يضيف دعمًا لـ Activity Result API الجديدة على Android مع طرح عقود جديدة للتعامل مع loadPaymentData نتائج مهمة. يمكنك البدء باستخدام واجهة برمجة التطبيقات من خلال إنشاء مشغّلات نتائج الأنشطة باستخدام العقدَين GetPaymentData وGetPaymentDataResult.

ديسمبر 2023

الإصدار التجريبي : يمكنك مشاركة ملاحظاتك من خلال أداة تتبُّع المشاكل.

تم إصدار الإصدار 19.3.0-beta01 من مكتبة Play Services Wallet، الذي يضيف دعمًا لـ Activity Result API الجديدة على Android مع طرح عقود جديدة للتعامل مع loadPaymentData نتائج المهمة. يمكنك البدء باستخدام واجهة برمجة التطبيقات من خلال إنشاء مشغّلات نتائج الأنشطة باستخدام العقدَين GetPaymentData وGetPaymentDataResult.

يؤدي هذا الإصدار إلى إيقاف الطريقة AutoResolveHelper#resolveTask(Task, Activity, int) نهائيًا. يُرجى استخدام عقود Activity Result API الجديدة التي تم طرحها في هذا الإصدار بدلاً من ذلك.

سبتمبر 2023

تم إصدار الإصدار 19.2.1 من مكتبة Play Services Wallet، الذي يعدّل PayButton API للرجوع إلى مادة عرض زر ثابتة للمستخدمين الذين لديهم إصدار من "خدمات Google Play" أقل من 23.21.0.

يونيو 2023

تمت ترقية PayButton API على Android من إصدار تجريبي إلى إصدار ثابت، مع تضمين التغييرات التالية:

نص الزر بنفس حجم شعار "GPay"
هوامش زر قابلة للضبط لتناسب الحد الأدنى والحد الأقصى لارتفاع الزر
نصف قطر زاوية قابل للضبط ليطابق تصميم واجهة المستخدم

أبريل 2023

الإصدار التجريبي:

• تمت إضافة PayButton API لنظام Android لإنشاء أزرار دفع في Google Pay مصمّمة باستخدام أحدث تصميم للعلامة التجارية في Google Pay. يمكنك الاطّلاع على مستندات المطوّرين للحصول على تعليمات حول الترقية إلى زر الدفع الجديد
.

فبراير 2023

الإصدار التجريبي:

• تمت إضافة بطاقات اختبار البوابة لتسهيل الاختبار الكامل. يمكن للتجّار اختيار إحدى هذه البطاقات للحصول على رمز مميّز يمكنهم إرساله إلى بيئة الاختبار الخاصة بمعالج الدفع وتلقّي الردود المناسبة. يُرجى الرجوع إلى مستندات مجموعة بطاقات الاختبار.

فبراير 2021

• تمت إضافة AsiaBill وbePaid وConnexPay وEpicPay وMixplat وNetopia وPaymentFusion وPikassa وPSCB إلى قائمة معالجات الدفع المشارِكة.
• تمت إضافة مادة عرض "علامة Google Pay" الجديدة إلى جميع الأمثلة في أفضل الممارسات المتعلّقة بتجربة المستخدم.

يناير 2021

• تمت إضافة CardKnox وCloud9 Payment Gateway (C9PG) وCorefy وPay.nl وReePay إلى قائمة معالجات الدفع المشارِكة .
• تمت إضافة مادة عرض "علامة Google Pay" الجديدة إلى إرشادات العلامات التجارية.

ديسمبر 2020

• تمت إضافة ЮKassa وIMOJE وModulbank وPayNearMe وQIWI وQualPay إلى قائمة معالجات الدفع المشارِكة.

نوفمبر 2020

• تمت إضافة AllPayments وCellPoint Mobile وEvopay وPrimer إلى قائمة معالجات الدفع المشارِكة.
• تمت إضافة تعليمات حول كيفية ضبط Google Pay API للامتثال لـ "المصادقة القوية للعملاء" (SCA) إلى SCA وGoogle Pay API.

أكتوبر 2020

• تمت إضافة InPlat وIntellectMoney وRebilly وTAS Link وUAPay إلى قائمة معالجات الدفع المشارِكة.
• تمت إضافة تعليمات حول كيفية استخدام قيمة رقم تعريف التاجر TEST لاختبار فك التشفير باستخدام مكتبة TINK إلى تشفير بيانات الدفع.

سبتمبر 2020

• تمت إضافة Alfa-Bank Ukraine وAsiaPay وBizzon وCredorax وPayload إلى قائمة معالجات الدفع المشارِكة.
• تمت إضافة فيديو يشرح Google Pay API باللغة البرتغالية البرازيلية إلى نظرة عامة.
• تمت إضافة رمز برمجي نموذجي وأمثلة بلغة البرمجة Kotlin إلى دليل توجيهي/تعليمي.
• تمت إضافة تعليمات حول كيفية الوصول إلى مجموعة بطاقات الاختبار في بيئة TEST إلى مجموعة بطاقات الاختبار.

يونيو 2020

• تمت إضافة ConcordPay وPayfacto وRadial إلى قائمة معالجات الدفع المشارِكة.

مايو 2020

• تمت إضافة Kassa إلى قائمة معالجات الدفع المشارِكة.
• تمت إضافة أشكال توضيحية لمسار الدفع تشرح العلاقة بين التجّار وGoogle ومعالجات الدفع إلى نظرة عامة.
• تمت إضافة مزيد من المعلومات حول المرجع إلى العميل isReadytoPay إلى مرجع.

أبريل 2020

• تمت إضافة FreedomPay وPaymo وOceanpayment وPayU India إلى قائمة معالجات الدفع المشارِكة.

مارس 2020

• تمت إضافة 2C2P وWindcave وdLocal وPaymentwall إلى قائمة معالجات الدفع المشارِكة.
• تمت إضافة قيم مَعلمة البوابة إلى برنامج تعليمي.
• تمت إضافة السمة allowedCreditCards إلى عنصر طلب CardParameters الذي يسمح للتجّار بفلترة معاملات بطاقات الائتمان إلى مرجع.
• تمت إضافة تعليمات حول كيفية الحصول على إذن بالإصدار العلني باستخدام التسجيل في Google Pay & Wallet Console إلى طلب إذن بالإصدار العلني.
• تمت إضافة تعليمات حول كيفية التواصل مع فريق الدعم لطرح الأسئلة الفنية وأسئلة الإعداد باستخدام Google Pay & Wallet Console إلى كيفية الحصول على المساعدة و تحديد المشاكل وحلّها.

فبراير 2020

• تمت إضافة PayOnline إلى قائمة معالجات الدفع المشارِكة.

يناير 2020

• تمت إضافة Paygent وJudopay وPaymark وe-SiTef - Software Express وnoon payments إلى قائمة معالجات الدفع المشارِكة.
• تمت إضافة طريقة عرض ملخّص إلى إرشادات العلامات التجارية.

ديسمبر 2019

• تمت إضافة Billing Systems وSpreedly وtheMAP وAPPEX إلى قائمة معالجات الدفع المشارِكة.
• تمت إضافة متطلبات التكامل DIRECT إلى نظرة عامة.

نوفمبر 2019

• تمت إضافة Tranzzo وMOBI.Money وSuntech وBest2Pay إلى قائمة معالجات الدفع المشارِكة.
• تمت إضافة OpenCart إلى قائمة الـ منصّات المشارِكة.

أكتوبر 2019

• تمت إضافة تعليمات حول كيفية تفعيل دعم البطاقات المجمّعة (بطاقة الائتمان وبطاقة السحب الآلي) في البرازيل في السمة allowedCardNetworks لعنصر طلب CardParameters إلى مرجع.

سبتمبر 2019

• تمت إضافة NCCC وeCard وBlueGate (NTTData) إلى قائمة معالجات الدفع المشارِكة.

أغسطس 2019

• تمت إضافة PayAnyWay وParagon Payment Solutions وPaylane إلى قائمة معالجات الدفع المشارِكة.
• تمت إزالة السمة merchantId من مثال العنصر MerchantInfo.
• تمت إضافة CheckoutActivity.java لاستبدال YourActivity.java إلى برنامج تعليمي.
• تمت إضافة PaymentsUtil.java لاستبدال GooglePay.java إلى برنامج تعليمي.
• تمت إضافة صور تكميلية جديدة إلى أفضل الممارسات المتعلّقة بتجربة المستخدم.
• تمت إضافة تعليمات حول كيفية تخصيص عملية التكامل للامتثال لـ "المصادقة القوية للعملاء" إلى المصادقة القوية للعملاء.

تمّوز (يوليو) 2019

• تمت إضافة Cathay United Bank وChase Merchant Services (المعروفة سابقًا باسم Chase Paymentech) وLogPay وNuvei و Payler وPaymetric وRBS إلى قائمة معالجات الدفع المشارِكة.

حزيران (يونيو) 2019

• تمت إضافة CardConnect وeGHL وLogPay إلى قائمة معالجات الدفع المشارِكة.
• تمت إضافة مجموعة متنوعة من أمثلة الرموز المميّزة إلى الاختبار باستخدام الرموز المميّزة النموذجية.
• تمت إضافة مزيد من المعلومات والأمثلة إلى أفضل الممارسات المتعلّقة بتجربة المستخدم.
• تمت إضافة خيار allowedCardNetworks جديد هو INTERAC إلى البرنامج التعليمي.

مايو 2019

• تمت إضافة Braspag وEcard وRedsys وWorldnet إلى قائمة معالجات الدفع المشارِكة.

نيسان (أبريل) 2019

• تمت إضافة Computop وMyCheck وSipay وTPay.com وWirecard إلى قائمة البوابات المتوافقة.
• تمت إضافة PayPal كطريقة دفع متوافقة في السمة type لعنصر طلب PaymentMethod إلى مرجع.

آذار (مارس) 2019

• تمت إضافة iQmetrix وPortmone وVindicia إلى قائمة معالجات الدفع المشارِكة.

شباط (فبراير) 2019

• تمت إضافة Gestpay وiPay88 وMultiCarta وSquare وWayForPay إلى قائمة معالجات الدفع المشارِكة.
• تمت إضافة مزيد من المعلومات حول التشفير والحمولات النموذجية التي يتم عرضها مع عملية تكامل a DIRECT إلى الاختبار باستخدام الرموز المميّزة النموذجية.
• تمت إضافة الأسئلة الشائعة حول المنتج وتحديد المشاكل وحلّها والإجابات عنها إلى الأسئلة الشائعة.

كانون الثاني (يناير) 2019

• تمت إضافة Assist وGMO Payment Gateway وMoneris إلى قائمة البوابات المتوافقة.

• تمت إضافة محتوى مترجَم باللغات التالية:

  • الروسية
  • البرتغالية (البرازيلية)
  • اليابانية
  • البولندية
  • الصينية (التقليدية)
• تمت إضافة أمثلة لمعالجات الدفع المشارِكة إلى الـ جدول البوابة و gatewayMerchantId سمات لعنصر طلب TokenizationSpecification مرجع.

كانون الأول (ديسمبر) 2018

• تمت إضافة اللغة العربية لمورد "الشراء باستخدام Google Pay" إلى إرشادات العلامات التجارية.
• تمت إضافة معلومات حول ECv2، وهو بروتوكول تشفير معدَّل يسمح للتجّار بتخزين مفتاح توقيع ثابت طويل الأجل من Google لا يحتاج إلى التعديل إلا كل 10 سنوات، لعمليات التكامل DIRECT إلى تشفير بيانات الدفع.
  ملاحظة: إذا كنت قد نفّذت دعمًا لـ ECv1، من المفترض أن يستمر التنفيذ في العمل. إذا أردت الترقية إلى ECv2 في بيئة الإنتاج، يُرجى إعلام جهة الاتصال في Google للتحقّق من عملية التنفيذ.
• تمت إضافة معلومات حول دعم حمولة ECv2 للإصدار 1.1.0 من مكتبة Tink إلى ملاحظات إصدار Tink.

نوفمبر 2018

• تمت إضافة NMI إلى قائمة معالجات الدفع المشارِكة .
• تمت إضافة مزيد من المعلومات حول علامة Google Pay إلى إرشادات العلامات التجارية.

أكتوبر 2018

• تمت إضافة تعليمات حول تدوير المفاتيح لعمليات التكامل DIRECT إلى تشفير بيانات الدفع.

سبتمبر 2018

• تمت إضافة معلومات حول APIv2 إلى عيّنة التعليمات البرمجية على GitHub.

أغسطس 2018

• تمت إضافة معلومات حول الإصدار الجديد من Google Pay API، وهو APIv2، إلى الترقية إلى أحدث إصدار.
  ملاحظة: من المفترض أن تستمر التطبيقات التي تم دمجها مع APIv1 في العمل.