Płatności typu przekierowanie mogą być inicjowane na 2 sposoby:
Gdy użytkownik wybierze opcję „Przekieruj płatność”, zostanie przekierowany na stronie integratora, aby wybrać formę płatności. W tym w żądaniu zostanie wpisana wartość
noFopChosen
. W takim przypadku integrator wyświetli użytkownikowi listę dostępnych wydawców. Jednorazowo użytkownik wybierze jedną z tych opcji, zostanie przekierowany do stronę lub aplikację, aby dokończyć zakup.Użytkownik wybiera formę płatności (wystawcę) podczas procesu zakupu. W tym przypadku Google wypełni
issuerId
i przekieruj użytkownika do integratora. Gdy integrator, powinien natychmiast przekierować użytkownika do witrynie lub aplikacji wydawcy, aby dokończyć zakup.
W obu tych przypadkach Google przekieruje użytkownika bezpośrednio do witryny integratora bez wcześniejszego wywołania serwer-serwer z Google.
Integrator musi wdrożyć protokół HTTPS za pomocą metody GET. Parametry GET opisane w sekcji Parametry żądania przekierowania, zawierają informacje o żądanej płatności za przekierowanie.
Integrator musi obsługiwać adresy URL o długości 2048 znaków. Obejmuje to m.in.: schemat, host, port, ścieżka i parametry. Wszystkie parametry będą zakodowane w formacie UTF-8. przed zakodowaniem w adresie URL.
Żądanie przekierowania
Oto przykład adresu URL, na który zostanie przekierowany użytkownik w ramach parametru Rozpocznij proces przekierowania (nazywany też żądaniem przekierowania):
https://www.integratordomain.com/example/redirectEndpoint?callbackUrl=https%3A%2F%2Fexample.google.com%2Freturn%2Furl%3FredirectRequestId%3DcmVxdWVzdDE&redirectRequest=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVRVUVTVF9QQVlMT0FEX0VYQU1QTEVfVEhBVF9JU19FTkNPREVEX1dJVEhfYmFzZTY0X1VSTC1TQUZFX0VOQ09ESU5H
Zdekodowana z adresu URL wartość parametru callbackUrl
w tym przykładzie:
https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE
Parametr redirectRequest
jest zaszyfrowany i podpisany za pomocą PGP
lub JWE+JWS
przed zakodowaniem base64url
.
Parametry żądania przekierowania
Żądanie HTTPS GET musi mieć następujące parametry zapytania:
Pola | |
---|---|
callbackUrl
|
string
Adres URL, na który ma zostać przekierowany użytkownik po dokonaniu płatności. Ta wartość jest zakodowany na potrzeby adresu URL i może mieć maksymalnie 512 znaków.
Ten adres URL będzie zawierał parametr |
redirectRequest
|
RedirectRequest
WYMAGANE: |