افزودن و حذف کردن تماس‌های برگشتی

این راهنما نحوه استفاده از فراخوانی‌های برگشتی با Google Wallet API را توضیح می‌دهد. وقتی مجوزی ایجاد یا حذف می‌شود، Google می‌تواند به نقطه پایانی HTTPS انتخابی شما فراخوانی برگشتی انجام دهد. این فراخوانی بازگشتی مختص کارت است و شامل داده‌هایی درباره رویداد مانند externalPassId و نوع رویداد است. از این گزارش می‌توان برای پیگیری تعداد افزودن‌ها و حذف‌های کاربر استفاده کرد. برای مثال، می‌توان فراخوانی‌های برگشتی را برای ارسال رویدادها به برنامه تجزیه‌وتحلیل پیکربندی کرد تا تعامل مشتری درطول رویدادهای تبلیغاتی پیگیری شود.

پیش‌نیازها

قبل‌از شروع، پیش‌نیازهای زیر را مرور کنید:

  • نقطه پایان HTTPS را که درخواست‌های POST را مدیریت می‌کند راه‌اندازی کنید. این نقطه پایانی باید به‌طور عمومی دردسترس باشد.
  • نشانی وب نقطه پایان فراخوانی برگشتی را برای صادرکننده به‌صورت برنامه‌نویسی‌شده به‌روز کنید. ویژگی callbackOptions را برای صادرکننده در REST API ببینید.
  • توصیه می‌شود: از کتابخانه Tink برای درستی‌سنجی امضاها استفاده کنید.

پیاده‌سازی پاسخ تماس

برای هر افزودن یا حذفی که کاربر روی مجوز انجام می‌دهد، Google با جزئیات مربوط به افزودن یا حذف در نشانی وب فراخوان صادرکننده به فروشندگان فراخوان می‌دهد. فروشندگان ابتدا باید از «کلیدهای عمومی» برای درستی‌سنجی اصالت پیام استفاده کنند. پس‌از اینکه فراخوانی‌های برگشتی پیام را تأیید کردند، می‌توان از فراخوانی‌های برگشتی برای عملیات پایین‌دستی استفاده کرد.

درستی‌سنجی کردن امضا

توصیه می‌کنیم هنگام پیاده‌سازی نقطه پایانی HTTPS، از کتابخانه Tink برای تأیید امضای پیام استفاده کنید. کتابخانه 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 است که به‌صورت رشته‌ای با ویژگی‌های زیر سریال‌سازی شده است:

شناسه شرح
externalPassId

شناسه مجوز خارجی کاملاً واجدشرایط. از قالب زیر استفاده می‌کند:

<issuer_id.external_pass_id>
expTimeMillis زمان انقضا برحسب میلی‌ثانیه از تاریخ. پس‌از زمان انقضا، پیام باید نامعتبر تلقی شود.
eventType می‌تواند del یا save برای DELETE و SAVE باشد.
nonce Nonce برای ردیابی هرگونه تحویل تکراری.

رسیدگی به درخواست از سرور Google

در زیر فهرستی از فیلدهای کلیدی در سرصفحه درخواستی که به نقطه پایانی فراخوان شما ارسال می‌شود آمده است:

  • User-Agent: Googlebot یا Google-Valuables
  • نوع محتوا: application/json

سرورتان را طوری پیکربندی کنید که درخواست را رد نکند. برای انجام این کار، می‌توانید موارد زیر را در robots.txt تنظیم کنید:

User-agent: Googlebot
Disallow:

تلاش‌های مجدد

تماس‌های برگشتی براساس حداکثر تلاش انجام می‌شود. Google از راهبردهای رایج تکرار استفاده خواهد کرد تا در مواردی که نقطه پایانی فراخوانی پاسخ نمی‌دهد یا قطعی متناوب دارد، انعطاف‌پذیر باشد و تلاش‌ها را به‌طور مناسبی کاهش خواهد داد.

ارسال تکراری

در برخی موارد ممکن است ارسال‌های تکراری وجود داشته باشد. توصیه می‌کنیم از nonce برای حذف موارد تکراری استفاده کنید.