開始重新導向流程

重新導向付款有兩種方法可以辦理:

  1. 當使用者選取「重新導向付款」時,系統會將他們重新導向至整合商的網站,以便選取要使用的付款方式 (FOP)。在這種情況下,系統會在要求中填入 noFopChosen。發生這種情況時,整合商會向使用者顯示可用核發者清單。使用者選取其中一個選項後,系統就會將使用者導向至該核發機構的網站/應用程式,以便完成購買交易。

  2. 使用者在購買流程中選取付款方式。在這種情況下,Google 會在要求中填入 issuerId 參數,並將使用者重新導向至整合商。整合商收到這封通知後,應立即將使用者重新導向至發卡機構的網站/應用程式,以便完成購買交易。

在這兩種情況下,Google 會將使用者直接重新導向至整合商的網站,不會先前的任何 Google 伺服器對伺服器呼叫。

整合商必須使用 GET 導入 HTTPS 通訊協定。重新導向要求參數中所述的 GET 參數會包含所要求重新導向款項的相關資訊。

整合商必須支援 2,048 個半形字元的網址。這包括配置、主機、通訊埠、路徑和參數。所有參數都會先採用 UTF-8 編碼,再進行網址編碼。

重新導向要求

以下網址範例會在開始重新導向流程 (亦稱為重新導向要求) 中將使用者重新導向:

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

在本範例中,callbackUrl 參數的網址解碼值如下:

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

redirectRequest 參數會先使用 PGPJWE+JWS 加密及簽署,然後再進行 base64url 編碼。

重新導向要求參數

HTTPS GET 要求必須包含下列查詢參數:

欄位
callbackUrl string

使用者付款完成後重新導向至的網址。這個值已經過網址編碼,長度上限為 512 個字元。

這個網址會在 redirectRequestId GET 參數中,加入加密 redirectRequestrequestId。廠商應驗證 callbackUrlredirectRequestId 和已加密酬載的 requestId 是否相同,以驗證兩者是否相關。

redirectRequest RedirectRequest

必要項目RedirectRequest 應使用 PGPJWE+JWS 加密及簽署。此外,這個值應採用網路安全的 base64 編碼。