Opis
Tokenizacja formy płatności może obsługiwać przypadek użycia numeru referencyjnego. Użytkownik, który chce zapłacić za towary, generuje numer referencyjny za pomocą integratora płatności. Następnie użytkownik zabiera ten numer referencyjny do sklepu, kiosku lub banku i opłaca ten numer.
FOP za gotówkę obsługuje też numer referencyjny. Główna różnica między tokenizowaną formą płatności a formą płatności gotówką polega na tym, że tokenizowana forma płatności wymaga powiązania i obsługuje zwroty środków. FOP nie wymaga powiązania i nie obsługuje zwrotów środków. W tym dokumencie opisano sposób działania integracji w przypadku użycia numeru referencyjnego.
Ogólnie integracja obejmuje następujące procesy:
- Przebieg uwierzytelniania
- Procedura powiązania
- Przepływ zakupów (tak samo jak w formie płatności gotówkowej)
- Proces zwrotu środków
- Proces przesyłania
Proces zakupu będzie taki sam jak w przypadku płatności gotówką.
Przykład integracji stosującej uwierzytelnianie przekierowania internetowego
Powiązane interfejsy API
Proces uwierzytelniania
Interfejs API wdrożony przez integratora: Uwierzytelnianie internetowe.
Proces tworzenia powiązania
Interfejs API wdrożony przez integratora: associateAccount z interfejsem API tokenizowanej formy płatności hostowanej przez integratora płatności.
Proces zakupu
Interfejs API wdrożony przez integratora: generateReferenceNumber i cancelReferenceNumber w interfejsie API FOP hostowanych przez integratora płatności.
Interfejs API zaimplementowany przez Google: referenceNumberPaidNotification w interfejsie Google Hosted FOP API.
Proces zwrotu środków
Interfejs API wdrożony przez integratora: refund w interfejsie API tokenizowanej formy płatności hostowanej przez integratora płatności.
Proces realizacji przelewu
Interfejs API wdrożony przez integratora: patrz Payment Integrator Hosted Remittance API (Interfejs API hostowanych przez integratora płatności).
Interfejs API wdrożony przez Google: patrz Hosted Remittance API.
Jak wszystkie procesy łączą się ze sobą
Utwórz instrument
W interfejsie Google użytkownik zostaje przekierowany na stronę internetową hostowaną przez integratora, aby przeprowadzić uwierzytelnianie internetowe. Po uwierzytelnieniu użytkownik zostanie przekierowany z powrotem do Google. Następnie Google wywoła metodę associateAccount. requestId w usłudze authenticationResponse będzie wartością authenticationRequestId z żądania associateAccount. Po udanym powiązaniu Google przechowuje googlePaymentToken(GPT) i inne metadane jako instrument dla użytkownika.
Utwórz instrument – proces uwierzytelniania
Utwórz instrument – procedura powiązania
Wygeneruj numer referencyjny
Gdy użytkownik chce kupić towary lub usługi za pomocą tego instrumentu, Google wywołuje metodę generateReferenceNumber za pomocą tagu GPT. requestId w nagłówku żądania generateReferenceNumber będzie służyć do identyfikowania transakcji dla powiązanych interfejsów API.
Numer referencyjny płatności
Gdy użytkownik opłaci numer referencyjny offline, integrator wywoła metodę referenceNumberPaidNotification. Element requestId w nagłówku żądania generateReferenceNumber będzie wartością generateReferenceNumberRequestId żądania referenceNumberPaidNotification.
Anulowanie transakcji
Jeśli użytkownik zdecyduje się anulować transakcję przed dokonaniem płatności, Google wywoła metodę cancelReferenceNumber. requestId w nagłówku żądania generateReferenceNumber będzie wartością generateReferenceNumberRequestId żądania cancelReferenceNumber.
Zwrot środków za transakcję
Jeśli po dokonaniu płatności za numer referencyjny użytkownik będzie chciał odzyskać pieniądze, Google zadzwoni pod numer refund. requestId w nagłówku żądania generateReferenceNumber będzie wartością transactionId żądania refund.
Przelew
Zgodnie z umową Google wywołuje funkcję remittanceStatementNotification, aby powiadomić integratora, gdy informacja będzie gotowa. Następnie integrator wywoła interfejs Google Remittance API, aby przeprowadzić uzgodnienie.