تراکنش‌های آغاز شده توسط فروشنده (MIT)

نمای کلی پشتیبانی MIT

تراکنش‌های آغاز شده توسط فروشنده (MITs) تراکنش‌هایی هستند که بدون حضور فعال کاربر در جلسه پردازش می‌شوند. این به‌روزرسانی در API گوگل پی آنلاین، امکان مشاهده بهتر این نوع تراکنش‌ها، بهبود تجربه کاربری از طریق تجربه کاربری اختصاصی جزئیات صورتحساب و بهبود تداوم پرداخت را فراهم می‌کند.

موارد استفاده کلیدی

  • پرداخت‌های دوره‌ای: سرویس‌های پخش دیجیتال، عضویت‌ها یا خدمات رفاهی.
  • پرداخت‌های معوق: رزرو هتل، پیش‌سفارش‌ها یا هزینه‌های عدم حضور.
  • شارژ مجدد خودکار: شارژ مجدد اعتبار ذخیره شده برای کارت‌های حمل و نقل عمومی یا هدیه.

پیاده‌سازی API در MIT

رابط برنامه‌نویسی کاربردی MIT، توسعه‌ای از رابط برنامه‌نویسی موجود است.loadPaymentDataAPI. یکپارچه‌سازها باید دقیقاً یک شیء *TransactionInfo را برای مشخص کردن هدف صورتحساب درج کنند. گوگل بسته به نوع تراکنش آغاز شده توسط فروشنده، 3 گزینه ارائه می‌دهد:

نوع تراکنش نام شیء توضیحات
تکرارشونده RecurringTransactionInfo برای هزینه‌های ثابت استفاده می‌شود. از دوره‌های آزمایشی، صورتحساب‌های پیش‌پرداخت و پس‌پرداخت پشتیبانی می‌کند.
به تعویق افتاده DeferredTransactionInfo برای یک بار شارژ در یک زمان از پیش تعیین شده در آینده استفاده می‌شود.
بارگیری مجدد خودکار AutomaticReloadTransactionInfo برای شارژ مجدد حساب با ارزش ذخیره شده، زمانی که موجودی آن از حداقل آستانه کمتر می‌شود، استفاده می‌شود.

مراحل ادغام

  1. مستندات: در طول برنامه دسترسی اولیه به DevSite دسترسی پیدا کنید. سه تعریف شیء جدید در بخش مرجع شیء قرار دارند و مستقیماً در لیست قبلی پیوند داده شده‌اند.
  2. پیاده‌سازی: از شیء(های) *TransactionInfo مربوط به سیستم خود در درخواست API خود استفاده کنید.
    • توجه داشته باشید که در هر درخواست فقط می‌توان یک شیء را به API ارسال کرد. تعیین اینکه از کدام شیء استفاده شود و فیلدها را پر کند، به عهده‌ی هر فروشنده است.
  3. آزمایش: از محیط TEST برای تأیید صحت نمایش جزئیات صورتحساب در فیش حقوقی استفاده کنید.
  4. راه‌اندازی: پس از تأیید پارامترها، به صورت زنده اجرا شود.

مدیریت چرخه عمر توکن (TLM)

مدیریت چرخه عمر توکن، با ارائه اعلان‌های بلادرنگ هنگام به‌روزرسانی یا غیرفعال شدن توکن‌های پرداخت امن، تداوم پرداخت را تضمین می‌کند. برای جزئیات کامل، بهمستندات مدیریت چرخه حیات توکن.

رویدادهای کلیدی توکن

  • غیرفعال‌سازی/حذف: زمانی که یک توکن دیگر قابل استفاده نیست، اطلاع می‌دهد.
  • به‌روزرسانی‌های پسوند FPAN: زمانی رخ می‌دهد که شماره حساب اصلی تأمین مالی به‌روزرسانی شود.

الزامات راه‌اندازی سرور

فروشندگان مستقیم و ارائه دهندگان خدمات پرداخت (PSP) باید سیستمی را برای دریافت، رمزگشایی و پردازش این پیام‌ها ایجاد کنند.

مورد نیاز توضیحات
نقطه پایانی نقطه پایانی HTTPS را برای دریافت تماس‌های POST ایمن کنید.
احراز هویت باید اعتبارسنجی امضا و رمزگشایی پیام را مدیریت کند.
پاسخ برای ادامه اعلان‌ها SUCCESS و برای متوقف کردن آنها TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE را برگردانید.
اعلان فروشنده PSPها باید وضعیت توکن را به فروشندگان خود اطلاع دهند.

یادداشت‌های اجرایی

برای دریافت به‌روزرسانی‌های توکن، باید نقطه پایانی tokenUpdateUrl همراه با تراکنش ارسال شود. برای PSPها، تعیین نحوه دریافت و پر کردن این URL توسط بازرگانان در شیء *TransactionInfo مربوطه، بر عهده PSP است که آن را تعریف کند.

همچنین توجه داشته باشید که فایل رمزگذاری شده، یک فیلد اختیاری اضافی، merchantTokenId ، برای MITها برمی‌گرداند. برای جزئیات بیشتر، بهرمزنگاری داده‌های پرداختمستندات (برای بازرگانان) یا مستندات ساختار بار مفید (برای PSPها).