إضافة طلبات معاودة الاتصال وحذفها

يشرح هذا الدليل كيفية استخدام عمليات معاودة الاتصال مع Google Wallet API. عندما تم إنشاء بطاقة أو حذفها، ويمكن أن تعاود Google الاتصال بخادم HTTPS نقطة نهاية من اختيارك. تكون معاودة الاتصال هذه خاصة بالفئة وتتضمن بيانات عن الحدث مثل الفئة والكائن ونوع الحدث. يمكن استخدام هذا تتبع عدد عمليات إضافة المستخدم وعمليات الحذف التي تحدث. بالنسبة على سبيل المثال، يمكن ضبط عمليات معاودة الاتصال لإرسال الأحداث إلى أحد الإحصاءات لتتبع تفاعل العملاء أثناء الأحداث الترويجية.

المتطلبات الأساسية

قبل البدء، راجع المتطلبات الأساسية التالية:

  • وضع نقطة نهاية HTTPS تعالج طلبات POST. تحتاج نقطة النهاية هذه أن تكون متاحة للجمهور.
  • تعديل نقطة نهاية معاودة الاتصال آليًا لكل فئة. يمكنك الاطّلاع على callbackOptions حسب الفئة في واجهة برمجة تطبيقات REST.
  • إجراء مقترَح: استخدِم مكتبة Tink للتحقّق من التوقيعات.

تنفيذ عمليات معاودة الاتصال

لكل عملية إضافة أو حذف يجريها المستخدم على كائن ، ترسل Google معاودة الاتصال إلى التجّار تحتوي على تفاصيل حول إضافة أو حذف لكل صف عنوان URL. يحتاج التجار أولاً إلى استخدام المفاتيح العامة للتحقق من صحة الرسالة. بعد أن تتحقّق عمليات معاودة الاتصال من الرسالة، يمكن استخدامها. لعمليات ما بعد المعالجة.

التحقّق من التوقيع

ننصحك باستخدام مكتبة Tink للتحقّق من توقيع الرسالة. عند تنفيذ نقطة نهاية HTTPS. تشير رسالة الأشكال البيانية مكتبة Tink توفر PaymentMethodTokenRecipient، وهي خدمة تلقائيًا على التحقق من التوقيع وعرض الرسالة الفعلية نجاح عملية التحقق.

يوضح المثال التالي كيفية استخدام مكتبة Tink لتنفيذ PaymentMethodTokenRecipient: 

import java.io.IOException;
import javax.servlet.http.*;
import com.google.common.io.CharStreams;
import com.google.crypto.tink.apps.paymentmethodtoken.*;

// Replace ISSUER_ID with your issuer id
private static final String RECIPIENT_ID = "ISSUER_ID";

private static final String PUBLIC_KEY_URL = "https://pay.google.com/gp/m/issuer/keys";
private static final String SENDER_ID = "GooglePayPasses";
private static final String PROTOCOL = "ECv2SigningOnly";

private static final GooglePaymentsPublicKeysManager keysManager = new GooglePaymentsPublicKeysManager.Builder()
        .setKeysUrl(PUBLIC_KEY_URL)
        .build();

public void doPost(HttpServletRequest request, HttpServletResponse response) throws IOException {
  try {
    // Extract signed message with signature from POST request body.
    String signedMessage = CharStreams.toString(request.getReader());
    PaymentMethodTokenRecipient recipient =
            new PaymentMethodTokenRecipient.Builder()
                    .protocolVersion(PROTOCOL)
                    .fetchSenderVerifyingKeysWith(keysManager)
                    .senderId(SENDER_ID)
                    .recipientId(RECIPIENT_ID)
                    .build();

    String serializedJsonMessage = recipient.unseal(signedMessage);

    // Use serializedJsonMessage to extract the details
  } catch (Exception e) {
    // Handle the error
  }
}

التنسيق المتوقع للرسالة

يكون تنسيق الرسالة بتنسيق JSON ويتم تقسيمه إلى سلسلة كما يلي: المواقع:

المُعرّف الوصف
classId

معرّف الصف المؤهل بالكامل. تستخدم التنسيق التالي:

<issuer_id.class_id>
objectId

رقم تعريف عنصر مؤهّل بالكامل تستخدم التنسيق التالي:

<issuer_id.object_id>
expTimeMillis وقت انتهاء الصلاحية بالمللي ثانية منذ EPOCH. بعد وقت انتهاء الصلاحية، يلزم اعتبار الرسالة غير صالحة.
eventType يمكن أن تكون إما del أو save DELETE وSAVE
nonce إشعار لتتبّع أي عمليات تسليم مكرّرة.

معالجة الطلب من خادم Google

فيما يلي قائمة بالحقول الرئيسية في عنوان الطلب يتم إرساله إلى نقطة نهاية معاودة الاتصال:

  • وكيل المستخدم: Googlebot
  • نوع المحتوى: application/json

اضبط الخادم بحيث لا يرفض الطلب. للقيام بذلك، يمكنك ضبط ما يلي في robots.txt: 

User-agent: Googlebot
Disallow:

إعادة المحاولة

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

عمليات تسليم متكرّرة

قد تكون هناك عمليات تسليم مكررة في بعض الحالات. ننصحك باستخدام nonce لإزالة التكرار منها.