Płatności przekierowania można zainicjować na 2 sposoby:
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.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 |
redirectRequest
|
RedirectRequest
WYMAGANE: |