Transakcje zainicjowane przez sprzedawcę (MIT)

Omówienie pomocy MIT

Transakcje zainicjowane przez sprzedawcę (MIT) to transakcje przetwarzane bez aktywnej sesji użytkownika. Ta aktualizacja interfejsu Google Pay Online API zapewnia większą widoczność tych typów transakcji, lepsze wrażenia użytkownika dzięki specjalnemu interfejsowi szczegółów płatności oraz większą ciągłość płatności.

Kluczowe przypadki użycia

  • Płatności cykliczne: cyfrowe usługi strumieniowe, subskrypcje lub usługi komunalne.
  • Płatności odroczone: rezerwacje hoteli, zamówienia w przedsprzedaży lub opłaty za niestawienie się.
  • Automatyczne doładowania: doładowania środków na kartach transportu publicznego lub kartach podarunkowych.

Implementacja interfejsu MIT API

Interfejs MIT API jest rozszerzeniem istniejącego interfejsu API. loadPaymentData Integratorzy muszą uwzględnić dokładnie 1 obiekt *TransactionInfo, aby określić zamiar dotyczący płatności. Google udostępnia 3 opcje w zależności od typu transakcji zainicjowanej przez sprzedawcę:

Typ transakcji Nazwa obiektu Opis
Cykliczny RecurringTransactionInfo Używany w przypadku opłat o stałej częstotliwości. Obsługuje okresy próbne, płatności przedpłacone i płatności po zakończeniu okresu rozliczeniowego.
Odroczono DeferredTransactionInfo Używane do jednorazowego obciążenia w określonym przyszłym terminie.
Automatyczne odświeżanie AutomaticReloadTransactionInfo Służy do doładowywania konta o wartości przechowywanej, gdy saldo spadnie poniżej minimalnego progu.

Kroki integracji

  1. Dokumentacja: dostęp do witryny dla deweloperów w ramach programu wcześniejszego dostępu. Trzy nowe definicje obiektów znajdują się w sekcji Odniesienie do obiektów i są bezpośrednio połączone z poprzednią listą.
  2. Implementacja: w żądaniu do interfejsu API użyj odpowiednich obiektów *TransactionInfo dla swojego systemu.
    • Pamiętaj, że w jednym żądaniu do interfejsu API można przekazać tylko jeden obiekt. Określenie, którego obiektu użyć, i wypełnienie pól należy do sprzedawcy.
  3. Testowanie: użyj środowiska TEST, aby sprawdzić, czy szczegóły rozliczeniowe są prawidłowo wyświetlane na liście płac.
  4. Uruchomienie: rozpocznij transmisję na żywo po zweryfikowaniu parametrów.

Zarządzanie cyklem życia tokena (TLM)

Zarządzanie cyklem życia tokena zapewnia ciągłość płatności dzięki powiadomieniom w czasie rzeczywistym o aktualizacji lub dezaktywacji bezpiecznych tokenów płatności. Szczegółowe informacje znajdziesz w dokumentacji zarządzania cyklem życia tokena .

Kluczowe zdarzenia związane z tokenami

  • Dezaktywacja lub usunięcie: powiadamia, gdy token nie jest już użyteczny.
  • Aktualizacje sufiksu FPAN: występują, gdy zaktualizowany zostanie numer głównego instrumentu płatności.

Wymagania dotyczące konfiguracji serwera

Bezpośredni sprzedawcy i dostawcy usług płatniczych (PSP) muszą utworzyć system do odbierania, odszyfrowywania i przetwarzania tych wiadomości.

Wymaganie Opis
Punkt końcowy Zabezpieczony punkt końcowy HTTPS do odbierania wywołań POST.
Uwierzytelnianie Musi obsługiwać weryfikację podpisu i odszyfrowywanie wiadomości.
Odpowiedź Zwróć wartość SUCCESS, aby kontynuować wysyłanie powiadomień, lub TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE, aby je zatrzymać.
Powiadomienie dla sprzedawcy Dostawcy usług płatniczych muszą informować sprzedawców o stanie tokena.

Uwagi dotyczące implementacji

Aby otrzymywać aktualizacje tokena, musisz przekazać punkt końcowy tokenUpdateUrl wraz z transakcją. W przypadku dostawców usług płatniczych określenie, w jaki sposób sprzedawcy będą otrzymywać i wypełniać ten adres URL w odpowiednim obiekcie *TransactionInfo, należy do dostawcy usług płatniczych.

Zwracamy też uwagę, że zaszyfrowany ładunek będzie zwracać dodatkowe pole opcjonalne, merchantTokenId w przypadku transakcji MIT. Szczegółowe informacje znajdziesz w dokumentacji Kryptografia danych płatności (dla sprzedawców) lub Struktura ładunku (dla dostawców usług płatniczych).