Rozpocznij przepływ przekierowania

Płatności przekierowania można zainicjować na 2 sposoby:

  1. Po wybraniu opcji „Przekieruj płatność” użytkownik zostanie przekierowany do witryny integratora, w której będzie mógł wybrać formę płatności. W tym przypadku pole noFopChosen zostanie wypełnione w żądaniu. W takim przypadku integrator wyświetla użytkownikowi listę dostępnych wydawców. Gdy użytkownik wybierze jedną z tych opcji, zostanie przekierowany do witryny lub aplikacji wydawcy, gdzie będzie mógł dokończyć zakup.

  2. Użytkownik wybiera formę płatności (wydawcą) podczas procesu zakupu. W takim przypadku Google wypełnia parametr issuerId w żądaniu i przekierowuje użytkownika do integratora. Po otrzymaniu tych informacji integrator powinien natychmiast przekierować użytkownika do witryny lub aplikacji wydawcy, gdzie może sfinalizować zakup.

W obu tych przypadkach Google przekierowuje użytkownika bezpośrednio do witryny integratora bez wcześniejszego wywołania serwer-serwer ze strony Google.

Integrator musi wdrożyć protokół HTTPS za pomocą metody GET. Parametry GET opisane w sekcji Parametry żądania przekierowania będą zawierać informacje o żądanej płatności za przekierowanie.

Integrator musi obsługiwać adresy URL o długości 2048 znaków. Dane te obejmują schemat, hosta, port, ścieżkę i parametry. Przed zakodowaniem adresu URL wszystkie parametry będą zakodowane w formacie UTF-8.

Prośba o przekierowanie

Oto przykład adresu URL, do którego zostanie przekierowany użytkownik w ramach procesu rozpoczynania przekierowania (nazywanego też żądaniem przekierowania):

https://www.integratordomain.com/example/redirectEndpoint?callbackUrl=https%3A%2F%2Fexample.google.com%2Freturn%2Furl%3FredirectRequestId%3DcmVxdWVzdDE&redirectRequest=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVRVUVTVF9QQVlMT0FEX0VYQU1QTEVfVEhBVF9JU19FTkNPREVEX1dJVEhfYmFzZTY0X1VSTC1TQUZFX0VOQ09ESU5H

Zdekodowana z adresem URL wartość parametru callbackUrl w tym przykładzie to:

https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE

Przed zakodowaniem base64url parametr redirectRequest jest zaszyfrowany i podpisany za pomocą PGP lub JWE+JWS.

Parametry żądania przekierowania

Żądanie HTTPS GET musi zawierać te parametry zapytania:

Pola
callbackUrl string

Adres URL, na który ma być przekierowany użytkownik po dokonaniu płatności. Ta wartość jest zakodowana na potrzeby adresu URL i może mieć maksymalnie 512 znaków.

Ten adres URL będzie zawierał parametr requestId z zaszyfrowanego redirectRequest w parametrze redirectRequestId GET. Dostawca powinien zweryfikować, czy redirectRequestId z callbackUrl i requestId z zaszyfrowanego ładunku są identyczne, aby sprawdzić, czy są powiązane.

redirectRequest RedirectRequest

WYMAGANE: RedirectRequest powinien być zaszyfrowany i podpisany przy użyciu PGP lub JWE+JWS. Ponadto ta wartość powinna być zakodowana bezpiecznie w internecie za pomocą kodu base64.