常見問題

本頁面提供有關 Google Pay API 的一般資訊和常見問題。

關於 Google Pay API

Google Pay 可在您的應用程式和網站中提供簡單好用的結帳功能。您的顧客可透過 Google Pay API 直接使用儲存在 Google 帳戶中的信用卡，在您的應用程式和網站上輕鬆結帳。

如何取得支援

透過 Google Pay 和錢包主控台註冊，然後選取「聯絡支援團隊」。我們可以協助你解決整合問題。此外，請參閱 Android 疑難排解指南和網路疑難排解指南，瞭解如何為整合過程中遇到的問題進行偵錯。

支援的功能

Google Pay API 有多項支援的功能。

支援的付款方式

Google Pay API 可能會傳回卡片或網路權杖。

注意：如要查看支援的付款方式，商家必須與付款處理方聯絡。

週期性付款和訂閱

週期性帳單的支援狀態與 Google Pay API 回應中傳回的付款方式相連結。代碼化卡片和已登錄的卡片皆可用於週期性帳單。商家無須按照特定頻率呼叫我們的 API，即可處理週期性帳單。付款憑證會儲存在商家端，以供週期性付款使用。商家會使用其付款閘道 API 來管理週期性帳單。

如果商家符合下列規定，就能透過 Google Pay 處理週期性付款：

• 商家確實遵守發卡機構訂定的規則，例如商家所發起交易的相關規範。
• 商家會在購買流程中揭露付款條款，使用者也選擇接受。

我們也支援金額不同的週期性帳單，例如行動電信業者的每月電話費帳單。如需相關詳細資料，商家必須與其付款閘道代表聯絡。

自動加值或「儲值」

商家無須反覆呼叫我們的 API，即可處理金額相同的自動加值作業。付款憑證會儲存在商家端並重複使用。如要進一步瞭解，商家必須聯絡其付款閘道代表。

交易退單

商家可依照處理其他付款形式的交易退單方式，來處理因取消、退款或爭議而產生的撤銷交易。如要進一步瞭解，商家必須聯絡其處理方代表。

募集捐款

已核准的非營利機構 (NPO) 可整合 Google Pay API 來募集捐款，但前提是該機構必須提供說明文件來證明、保證及驗證其非營利狀態。例如，美國的非營利組織必須提供來自 IRS 的有效 501(c)3 狀態證明才能符合資格。

條款與政策

Google Pay API 服務條款

所有商家都必須同意並遵守 Google Pay API《服務條款》。

Google Pay API 使用限制政策

所有商家都必須同意並遵守《Google Pay API 使用限制政策》。

賭博政策

Google Pay API《使用限制政策》中定義了賭博政策。

賭博政策可能會不時變更。所有提交內容都必須經過審查並獲得核准。

我們接受下列國家/地區的公司整合博奕遊戲：

• 澳洲
• 加拿大
• 捷克
• 法國
• 喬治亞
• 德國
• 希臘
• 匈牙利
• 愛爾蘭
• 義大利
• 日本
• 荷蘭
• 波蘭
• 葡萄牙
• 羅馬尼亞
• 西班牙
• 瑞典
• 英國

未來我們可能會進一步拓展支援範圍。

如要取得 Google Pay API 的正式版服務存取權限，以整合賭博功能，必須先完成下列一系列必要條件：

• 如果您在上述國家/地區設有僅限 Android 的賭博整合功能，請務必先遵守 Google Play 的賭博政策，並完成 Google Play 的審查程序。接著，我們會評估您僅限 Android 的整合作業，是否符合 Google Pay API 正式版服務的存取資格。
• 如果您在上述國家/地區提供僅限網站的賭博整合服務，則必須在 Google Pay API 的新手上路程序中，提交授權執照，證明您有資格在該國家/地區提供賭博服務。我們會評估您僅限網站的整合作業，是否符合 Google Pay API 正式版服務的存取資格。
• 如果您在上述國家/地區同時整合 Android 和網頁賭博功能，請務必先遵守 Google Play 的賭博政策，並完成 Google Play 的審查程序。接著，我們會評估您的 Android 和網站整合項目，確認是否符合 Google Pay API 正式版服務的存取資格。

設有特定條件或限制的國家/地區

如果符合下列條件，即可在列出的國家/地區整合賭博功能：

國家/地區	Android 整合資格	網站整合資格
保加利亞	可以，但設有限制： 重新導向至網站的應用程式符合資格。 應用程式不得未重新導向至網站。	是
賽普勒斯	可以，但設有限制： 州立彩券符合資格。 OPAP Cyprus Limited 符合資格。 禁止宣傳線上賭場。 禁止宣傳吃角子老虎機。 禁止提供賽馬賭彩。 禁止提供賽狗賭博。 禁止點差交易。 禁止宣傳賭博交易平台。	可以，但設有限制： 州立彩券符合資格。 OPAP Cyprus Limited 符合資格。 禁止宣傳線上賭場。 禁止宣傳吃角子老虎機。 禁止提供賽馬賭彩。 禁止提供賽狗賭博。 禁止點差交易。 禁止宣傳賭博交易平台。
芬蘭	可以，但設有限制： Veikkaus Oy 符合資格。	可以，但設有限制： Veikkaus Oy 符合資格。
哈薩克	可以，但設有限制： 彩券符合資格。 運動投注。 總彩池符合資格。 禁止宣傳線上賭場。 禁止宣傳電子賭場。	可以，但設有限制： 彩券符合資格。 運動投注。 總彩池符合資格。 禁止宣傳線上賭場。 禁止宣傳電子賭場。
波蘭	否	可以，但設有限制： 已取得執照的賭博供應商符合資格。
南非	可以，但設有限制： 線上運動投注彩券符合資格。	可以，但設有限制： 線上運動投注彩券符合資格。

如果想在先前未獲核准的國家/地區擴展 Google Pay API，請與我們聯絡，以取得擴展核准。請注意，您必須為計畫提供賭博相關服務的每個國家/地區，分別提供授權賭博執照。如果賭博服務的目標對象 / 服務對象是未成年人，或當地法律禁止賭博者，我們不允許使用 Google Pay API。

健康政策

Google Pay API《使用限制政策》中定義了醫療保健政策。

在啟用時，請準備好分享相關執照，以驗證您的醫療保健用途。所有提交內容都必須經過審查並獲得核准。

金融服務政策

Google Pay API《使用限制政策》中定義了金融服務政策。

在啟用金融服務時，請準備好提供相關執照，以驗證您的金融服務用途。所有提交內容都必須經過審查並獲得核准。

一般常見問題

以下是適用於商家的常見問題：

我使用知名的付款服務供應商 (PSP) 管理所有風險和嚴格客戶驗證 (SCA)。關於 GPay，我應該瞭解哪些事項？

Google Pay API 會利用已簽署的加密酬載傳回付款方式。傳回的付款方式是由 PAN 或是裝置 PAN (DPAN) 和密文構成的權杖化卡片所組成。

權杖化卡片酬載的處理過程不需要額外進階程序或驗證。

由 PAN 組成的卡片酬載必須透過內部或 PSP 提供的解決方案啟用 3D Secure。

如果您的 PSP 會管理所有風險和 SCA 邏輯，請確定您的 Google Pay API 整合功能包含下列屬性：

• merchantInfo.merchantName (Android、網頁版)：商家名稱會顯示在付款畫面中。
• transactionInfo.countryCode (Android、網頁版)：代表交易處理程序所在的國家/地區。您必須指定收單銀行的國家/地區。
• transactionInfo.totalPrice (Android、網頁版)：交易總金額的值，可選用位數至小數點後兩位。

如何取得 Google 商家 ID？

Google 核准您的網站後，您就能取得 Google 商家 ID。如要啟動程序，請登入 Google Pay 和錢包主控台，並建立 Google Pay API 整合。您必須提供完整網域清單 (包含子網域)，以便呼叫 Google Pay API。

注意：如要提交超過 50 個完整網域 (包括子網域)，請使用這份表單尋求替代解決方案。

我們可以在多個品牌和管道 (網站/應用程式) 中使用單一商家 ID 嗎？

可以，我們支援跨多個品牌和平台 (例如網站和 Android) 使用單一商家 ID，且一般建議這麼做，以簡化對帳程序。

商家如何在其應用程式和網站中提高使用者對 Google Pay 的接受度？

如要強調自己支援 Google Pay，請務必使用我們在 Android和網頁版品牌規範中提供的素材資源。

如有 Android 整合，您可在「Play 商店」說明中加註現可支援 Google Pay。針對網頁版整合，您可以直接在商家網站中新增說明。

電子商務平台是否支援 Google Pay？

是，您可以透過 Google Pay API 使用電子商務平台。如為代表商家代管結帳頁面的付款處理方、閘道或電子商務平台合作夥伴，即可使用 Google Pay 的代管結帳功能。

哪些付款服務供應商支援 Google Pay？

如要尋找支援 Google Pay 的處理方清單，請參閱我們的 Google Pay 處理方清單。

Google Pay 支援哪些國家/地區？

請查看支援使用 Google Pay 在線上或應用程式中付款的 國家/地區清單。

Google Pay 權杖 (CRYPTOGRAM_3DS) 支援哪些國家/地區和區域？

請參閱查看店內和感應支付功能支援的付款方式頁面，即可查看支援 Google Pay 權杖 (CRYPTOGRAM_3DS) 的國家/地區和當地銀行清單。其中會列出支援和不支援的卡片。

Google Play 應用程式內結帳和 Google Pay API 有何不同？

根據 Play 開發人員政策中心規定，在 Android 應用程式上銷售數位商品和服務的 Google Play 開發人員必須使用 Google Play 應用程式內結帳。應用程式內結帳的範例包括虛擬遊戲產品、應用程式功能或內容，以及雲端軟體產品。如要進一步瞭解應用程式內結帳，請參閱 Google Play 帳款服務總覽。

在應用程式內使用時，Google Pay API 僅適用於實體產品和服務。

Google Pay 是否會收取任何費用？

Google Pay 不會向使用者、商家和開發人員收取額外費用，以使用 Google Pay API 處理付款。不過，商家必須繼續支付手續費給付款處理方。

Google 如何驗證憑證及防止詐騙？

所有新增至 Google 的卡片都必須通過驗證授權，以驗證包括信用卡驗證碼 (CVC) 在內的卡片資料。Google 也會執行以付款方式資料、Google 帳戶個人資料、購買記錄、位置和裝置資訊為基礎的專屬風險引擎。 不過，商家必須繼續使用其目前的詐騙和風險評估工具來處理 Google Pay 的交易記錄。

行動應用程式 WebView 是否支援 Google Pay？

只要新增必要的 WebKit 依附元件，Android WebView 就能完全支援 Google Pay，並模擬行動版網站體驗。不過，由於 iOS 對第三方 Cookie 的限制，在 iOS WebView 中，isReadyToPay API 一律會傳回 false。Android 應用程式和 WebView 中的網站網域都必須獲得核准，才能取得正式版服務的存取權。如需具體實作方式，請參閱「使用 Android WebView」或「使用 iOS WKWebview」說明文件。

我的處理器不在清單中。我還能與 Google Pay 整合嗎？

Google Pay 持續與電子商務平台和付款處理服務供應商建立合作關係。 如果找不到處理方，請前往 g.co/pay/processors 提出要求。處理器可供使用時，系統會通知你。

如果我已有付款處理方或付款平台供應商，該如何啟用 Google Pay？

Google Pay 支援多種付款服務供應商和 電子商務平台供應商。每個主題都提供專屬的說明文件，協助您輕鬆上手，並搭配主要教學課程，讓您輕鬆完成新手上路程序。

如果我是支援的付款處理方，如何大規模向商家提供 Google Pay？

支援的付款處理方可以為網路整合項目導入代管結帳解決方案。 透過代管結帳功能，客戶可以向消費者提供 Google Pay，並略過個別的 Google Pay 上線程序。

如要開始使用，你必須先加入支援的付款處理服務。如要整合代管結帳解決方案，請與協助您完成新手上路的 Google 技術聯絡窗口聯絡。

如果我在結帳流程中提供運送服務，Google Pay 如何為使用者提供不同的運送選項和價格？

如果是網頁整合，您需要運送地址，並在 PaymentDataRequest 物件、PaymentOptions 物件和 PaymentDataCallbacks 物件中顯示不同的運送選項和價格。如需範例情境，請參閱動態價格更新示範。

如果是 Android 整合，您需要在 PaymentDataRequest 物件中提供運送地址。

如何收取透過 Google Pay 付款的款項？

Google Pay API 會將使用者的付款資訊傳送給付款服務供應商，以利交易。這項服務不會納入金流，而是設計為在現有付款基礎架構上運作。

取得正式版存取權的條件為何？

商家必須在 Google Pay 和錢包主控台中建立商家檔案，並上傳購買流程的螢幕截圖供審查。如要使用 Google Pay API，必須個別提交每個網域以供核准，因為系統不支援萬用字元網域 (例如 *.merchant.com) 則不接受。 詳情請參閱「發布整合」頁面的 Android 和/或 Web 部分。

如何瞭解整合提交狀態，以及是否需要在審查程序後進行任何變更？

提交 Google Pay API 整合項目以供審查後，您會收到電子郵件通知結果。如果您的整合功能符合我們的「可接受的使用方式政策」和品牌宣傳指南，就會獲得核准，並在 Google Pay 和錢包主控台中顯示「有效」狀態。如果需要變更，狀態會顯示「需要更多資訊」，電子郵件則會詳細說明需要修正的內容，請修正後再重新提交。如對提交內容有任何疑問，可以直接透過 Google Pay 和錢包主控台與支援團隊聯絡。

如果看到錯誤訊息，如何排解 Google Pay API 整合問題？

如要瞭解常見錯誤代碼和解決方法，請參閱 Android 和網頁的疑難排解指南。如有其他問題，請透過 Google Pay 和錢包主控台與支援團隊聯絡。

如何自訂 Google Pay API 整合，限制可用的卡片？

如要自訂資訊卡，請使用 Android 和 網頁的 CardParameters 物件。舉例來說，你可以選擇要允許的卡片網路和卡片發行國家/地區。

什麼是 Google Pay API？

有了 Google Pay API，顧客只要按一下按鈕，就能以儲存在 Google 帳戶中的付款方式消費。數百萬名使用者共儲存了數億張卡片，他們只要透過 API 就能輕鬆結帳。這項服務可提高安全性，從 Google 伺服器到付款處理方的傳輸過程中，以端對端加密機制保護顧客付款資料。整合程序簡單易上手，可搭配您現有的付款處理堆疊，只需新增幾行程式碼即可完成導入作業。

Google Pay API 和 Google Wallet API 有何關聯？

Google Pay API 和 Google Wallet API 是兩個不同的 API。Google Pay API 可讓顧客在您的網站或 Android 應用程式上，使用 Google Pay 做為付款方式。開發人員可透過 Google 錢包 API 建立及管理各種用途的數位票證。例如會員卡、票券、通行證、健康記錄和其他可自訂的項目。如要進一步瞭解 Google Wallet API，請參閱 Google Wallet API 開發人員說明文件。

目前的 Google Pay API 版本為何？更新作業如何處理？

目前版本列於 Android 和 網頁說明文件中。Google 維護這個版本已有數年，只新增了功能和選填欄位。API 的任何更新都具備回溯相容性，確保目前的整合不會中斷。

哪些平台支援 DPAN (CRYPTOGRAM_3DS)，哪些平台支援 FPAN (PAN_ONLY)？

DPAN 僅適用於 Android，且僅在透過 Android 裝置或 Android 行動版網頁/WebView 結帳時提供。桌機網頁和 iOS 裝置不支援 DPAN，預設會傳回 PAN_ONLY。

如何區分 DPAN 和 FPAN，以及如何處理這兩種 PAN？

assuranceDetails 物件的設計目的，是協助商家判斷交易是否需要透過 3D Secure 進行驗證，以符合嚴格客戶驗證 (SCA) 規定，而非嚴格區分 DPAN 與 FPAN。如要接收這些詳細資料，商家必須在 Google Pay API 要求中，將 assuranceDetailsRequired: true 新增至「卡片參數」。

cardHolderAuthenticated 和 accountVerified 有何不同？

如果要求中的 assuranceDetailsRequired 設為 true，回應會包含下列兩個屬性：

• accountVerified：表示用於付款的卡片為真卡，且帳戶狀態良好。不過，單獨進行這項驗證無法提供授權保護。
• cardHolderAuthenticated：表示使用者透過 Android 裝置展開交易，並使用佈建的以裝置為基礎發卡機構代碼。

我們如何使用這些標記觸發 3D Secure？

商家應使用這些標記建立 3D Secure 觸發邏輯。如果 cardHolderAuthenticated 和 accountVerified 都傳回 true，則視為憑證安全無虞且符合 SCA 規定，您不需進一步進行 3DS 驗證來提升交易安全。

如果商家設定 assuranceDetailsRequired: true，是否會收到電子商務權杖？

否，電子商務代碼是在 PSP 層級控管。

Google Pay 交易是否符合責任轉移資格？

責任轉移的適用情形取決於發卡機構。MasterCard 會自動為符合資格的代碼交易提供這項資訊，但 Visa 規定商家必須透過 Google Pay 管理中心手動選擇加入。詳情請參閱「啟用 Visa 責任轉移」。

如何辨識先買後付交易？

目前沒有先買後付交易的專屬 ID。系統會將這些憑證視為一般 FPAN 憑證。

Google 是否提供測試卡片，以測試 SCA 情境？

Google Pay API 無法直接提供任何 SCA 測試卡片。您的 PSP 應可在沙箱環境中使用測試卡片套件，滿足您的測試需求。

加密付款憑證的到期日或存留時間 (TTL) 是多久？

加密的 Google Pay 酬載會在整整一週後失效。如果商家處理延遲授權或非同步處理作業，必須確保在酬載過期前，透過支付服務供應商 (PSP) 授權付款。

如何處理退款和重新授權等交易後作業？

Google Pay 不會參與金流，僅會傳遞權杖化憑證。完成初始交易後，付款服務供應商 (PSP) 會將加密酬載中的付款資訊對應至自有權杖 (例如「商家權杖」或「客戶設定檔 ID」)。所有交易後互動和款項轉移，都完全由你和 PSP 管理。