تحديد المشاكل وحلّها

يتناول دليل تحديد المشاكل وحلّها على Android المشاكل والأسئلة المتعلقة بالمواضيع التالية.

يتم تشغيل التطبيق حاليًا في بيئة اختبار

قد تظهر للمستخدم الرسالة التالية عند اختيار بطاقة دفع من مربّع حوار تفاصيل الدفع:

يتم تشغيل التطبيق حاليًا في بيئة اختبار. ولن تؤدي المعاملات إلى تحصيل أي رسوم فعلية

يشير هذا الخطأ إلى أنّ التطبيق يستخدم ENVIRONMENT_TEST ولا يتلقّى بيانات اعتماد دفع حقيقية، بل يتلقّى معلومات شخصية تتضمّن عنوان الفوترة ورقم هاتف عنوان الفوترة وعنوان الشحن وعنوان البريد الإلكتروني إذا طُلب ذلك.

فشل الطلب

رسالة الخطأ الأكثر شيوعًا هي OR_BIBED_06. تظهر رسالة الخطأ هذه أيضًا في واجهة المستخدم على شكل مربّع حوار يتضمّن النص التالي:

تعذّر إكمال الطلب
هناك مشكلة في عملية دمج Google Pay لدى التاجر. يُرجى التواصل مع التاجر للحصول على المساعدة أو الدفع باستخدام طريقة أخرى.

لمزيد من المعلومات عن هذا الخطأ، اتّبِع الخطوات التالية:

  1. تأكَّد من تثبيت Android Debug Bridge (adb) على جهاز الكمبيوتر.
  2. تأكَّد من تفعيل خيار "تصحيح أخطاء الجهاز عبر USB" على جهازك. لمزيد من المعلومات، يُرجى الاطّلاع على تصحيح أخطاء تطبيقك.
  3. وصِّل جهاز Android بالكمبيوتر أو ابدأ المحاكي.

  4. نفِّذ الأمر التالي في الوحدة الطرفية أو موجّه الأوامر على جهاز الكمبيوتر:

    adb logcat -s WalletMerchantError

يشير الرد إلى سبب الخطأ. على سبيل المثال، قد يظهر لك ما يلي:

02-26 17:41:28.133 14593 14593 W WalletMerchantError: Error in loadPaymentData: This
merchant profile does not have access to this feature.

يعتمد الإجراء الذي عليك اتّخاذه لحلّ المشكلة على رسالة الخطأ.

صلاحية البوابة

قد تواجه الأخطاء التالية المتعلقة بصلاحية البوابة في مرحلة ما من عملية الدمج. تقدّم القائمة التالية بعض النصائح المفيدة لتحديد المشاكل وحلّها في حال حدوث هذه الأخطاء.

OR_BIBED_06 بوابة غير معروفة 'yourgateway'
قيمة السمة gateway التي حدّدتها في tokenizationSpecification غير متاحة حاليًا في Google Pay API. يُرجى التواصل مع بوابة الدفع للحصول على مزيد من المعلومات حول معرّف البوابة والحقول المرتبطة بها، مثل gatewayMerchantId.
لا يمكن استخدام البوابة OR_BIBED_06 "example" في وضع الإنتاج.
لا يتم استخدام قيمة مثال لخاصية البوابة إلا لأغراض الاختبار، ولا يمكن استخدامها مع قيمة مَعلمة بيئة WalletOptions تم ضبطها على WalletConstants.ENVIRONMENT_PRODUCTION. يُرجى التواصل مع بوابة الدفع للحصول على مزيد من المعلومات حول مَعلمات gateway التي عليك استخدامها مع Google Pay API.

التسجيل وإمكانية الوصول

قد تواجه الأخطاء التالية المتعلقة بالتسجيل والوصول في مرحلة ما من عملية الدمج. تقدّم القائمة التالية بعض النصائح المفيدة لتحديد المشاكل وحلّها في حال حدوث هذه الأخطاء.

OR_BIBED_07 تتطلّب واجهة برمجة التطبيقات هذه الإصدار 8.4 أو إصدارًا أحدث من مكتبة "خدمات Google Play".
تأكَّد من تحديث "خدمات Google Play" على الجهاز الذي يشغّل التطبيق.
OR_BIBED_07 لم يتم العثور على أي مفاتيح لملف التاجر هذا
يجب تسجيل مفتاح التشفير العام لدى Google باستخدام Google Pay & Wallet Console لإكمال عملية دمج DIRECT tokenizationSpecification type.
OR_BIBED_07 لا يمكن الوصول إلى هذه الميزة من خلال ملف التاجر هذا.
لم تُكمل عملية تسجيل تطبيقك في Google Pay API. راجِع مقالة طلب إذن بالإصدار العلني للحصول على مزيد من المعلومات.
OR_BIBED_10 هذا التاجر متاح في منطقة لا يُقبل فيها الدفع باستخدام Google Pay.
خدمة Google Pay غير متاحة في المنطقة. يمكنك الاطّلاع على قائمة البلدان التي تتوفّر فيها الميزة للحصول على مزيد من المعلومات
OR_BIBED_11 لم يكمل هذا التاجر عملية التسجيل لاستخدام Google Pay API. يُرجى الانتقال إلى وحدة التحكّم (https://pay.google.com/business/console) لإثبات الملكية.
لم تُكمل عملية تسجيل تطبيقك في Google Pay API. راجِع مقالة طلب إذن بالإصدار العلني للحصول على مزيد من المعلومات.
OR_BIBED_12 تم إيقاف عملية الدمج هذه مع Google Pay API. يُرجى التواصل معنا للحصول على مزيد من المعلومات (https://developers.google.com/pay/api/faq#how-to-get-support).
يُرجى
التواصل معنا لمعرفة المزيد من المعلومات حول الخطوات المطلوبة لإعادة تفعيل Google Pay API لحسابك.
لا تتطابق OR_BIBED_13 الملفات المرجعية لمفتاح التوقيع {11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:11:22:33:44:55} مع سجلاتنا لهذا التطبيق.
لا يمكن استخدام Google Pay API في وضع الإنتاج إلا إذا تم توقيع حزمة APK باستخدام مفتاح التوقيع الصحيح. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة توقيع تطبيقك.

التجّار المباشرون

قد تواجه الأخطاء التالية المتعلقة بالتاجر المباشر في مرحلة ما من عملية الدمج. تقدّم القائمة التالية بعض النصائح المفيدة لتحديد المشاكل وحلّها في حال حدوث هذه الأخطاء.

التحقّق من التوقيع
قد تواجه خطأ في التحقّق من صحة التوقيع إذا كان merchantId غير صحيح. يمكن أن يحدث ذلك في بيئة TEST عند استخدام مكتبة paymentmethodtoken في Tink. لتجنُّب هذه المشكلة، اضبط قيمة YOUR_MERCHANT_ID على في:
.recipientId("merchant:YOUR_MERCHANT_ID")
يتعذّر فك تشفير الرمز المميّز
إذا كنت تستخدم مكتبة Tink paymentmethodtoken لإلغاء تشفير الرمز المميّز، يُرجى الانتباه إلى ما يلي:
  • تأكَّد من أنّ بيئة الردّ في Google Pay API تتوافق مع بيئة Tink. على سبيل المثال، إذا تم عرض ردّ Google Pay API من خلال ENVIRONMENT_TEST، يشير Tink إلى بيئة الاختبار لفك التشفير.
  • لا تعدِّل الردّ من Google Pay API قبل تمريره إلى Tink. تأكَّد من إدخال الرمز المميز الكامل الذي تم إرجاعه من الردّ الناتج عن Google Pay API. لمزيد من التفاصيل، يُرجى الاطّلاع على الملاحظة التالية:
  • تأكَّد من أنّ لديك المفتاح الخاص المناسب المرتبط بالمفتاح العام الذي سجّلته لدى Google.
إنشاء مفتاحَي تشفير عام وخاص على Windows
إذا كنت تستخدم نظام التشغيل Windows وأردت اتّباع الخطوات المذكورة في استخدام OpenSSL لإنشاء زوج من المفاتيح الخاصة والعامة، احرص على تثبيت Cygwin على جهازك. هذا الإعداد مطلوب لتنفيذ أوامر Linux.

Android WebView

OR_BIBED_15 تعذّر تحميل Google Pay بشكل صحيح لأنّ هذا التطبيق يستخدم WebView. على مطوّري التطبيقات اتّباع التعليمات لتفعيل Google Pay في Android WebView.
اتّبِع التعليمات لتفعيل Google Pay API في Android WebView.

CardInfo

ما هي ميزة CardInfo؟
توضّح Google Pay للمستهلكين أنّ هناك بطاقة مرتبطة بزر الدفع في Google Pay، ما يعرض شبكة العلامة التجارية للبطاقة وآخر أربعة أرقام من البطاقة.
لماذا لا يتم عرض ميزة CardInfo في عملية التنفيذ؟

لكي تعمل ميزة CardInfo، يجب استيفاء الشروط التالية:

  • يجب تنفيذ واجهة برمجة التطبيقات createButton.
  • يجب ضبط ButtonOptions.buttonType على buy أو long أو pay.
  • يجب أن تتوفّر لدى المستخدم طريقة دفع، كما هو محدّد في عنصر CardParameters.