常見問題

本頁面提供 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 支援週期性付款：

  • 商家遵守網路規則，例如商家發起的交易。
  • 使用者在商家的購買流程中，已瞭解並接受付款條款。

我們也支援金額不定的週期性付款。例如，支援行動電信業者的每月電話費。如要瞭解詳情，商家必須與 Payment Gateway 代表聯絡。

自動加值或「儲值」

如要以相同費用處理自動儲值費用，商家不必每次都呼叫我們的 API。付款憑證會儲存在商家端，並可重複使用。如要瞭解詳情，商家必須與付款閘道代表聯絡。

交易退單

商家可以處理取消、退款或爭議的交易撤銷，就像處理其他付款方式的交易退單一樣。如要瞭解詳情，商家必須與處理方代表聯絡。

募集捐款

核准的非營利機構 (NPO) 只要提供文件證明、認證及驗證其非營利狀態，即可整合 Google Pay API 收集捐款。舉例來說，美國非營利機構必須提供 IRS 核發的有效 501(c)3 資格證明，才符合申請資格。

條款與政策

Google Pay 服務條款

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

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。
我們可以在多個品牌和管道 (網站/應用程式) 使用同一個商家 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 Wallet 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，以及如何處理這兩者？
assuranceDetails 物件並非用於嚴格區分 DPAN 和 FPAN，而是協助商家判斷交易是否需要透過 3D Secure 升級，以符合嚴格客戶驗證 (SCA) 規定。如要接收這些詳細資料，商家必須在 Google Pay API 要求中，將 assuranceDetailsRequired: true 新增至 Card 參數。
cardHolderAuthenticated 和 accountVerified 有何不同？
在要求中將 assuranceDetailsRequired 設為 true 時，回應會包含下列兩個屬性：
  • accountVerified：表示付款卡片為真，且帳戶記錄良好。不過，這項驗證本身不提供授權保護。
  • cardHolderAuthenticated：表示使用者透過 Android 裝置開始交易，並使用已佈建的裝置型網路權杖。
如何使用這些標記觸發 3D Secure？
商家應使用這些標記建立 3D Secure 觸發邏輯。如果 cardHolderAuthenticated 和 accountVerified 都傳回 true，則視為高安全性憑證，且符合 SCA 規定，您不需要進一步進行 3DS 驗證來提升交易安全性。
如果商家設定 assuranceDetailsRequired: true，是否會收到電子商務權杖？
否，電子商務權杖是在 PSP 層級控管。
Google Pay 交易是否適用責任轉移？
是否適用責任轉移，取決於發卡機構。 詳情請參閱「啟用 Visa 責任轉移」。
如何辨識先買後付交易？
目前沒有先買後付交易的專屬 ID。在系統中會顯示為一般 FPAN 憑證。
Google 是否能提供測試卡片，用於測試 SCA 情境？
Google Pay API 無法直接提供任何 SCA 測試卡。您的 PSP 應能在沙箱環境中使用測試卡片套件，滿足您的測試需求。
加密付款憑證的到期日或存留時間 (TTL) 是多久？
加密的 Google Pay 酬載會在整整一週後失效。處理延遲授權或非同步處理的商家，必須確保在酬載過期前，透過付款服務供應商 (PSP) 授權付款。
如何處理退款和重新授權等購買後作業？
Google Pay 不會經手款項，僅做為代碼化憑證的支付管道。初始交易發生後，付款服務供應商 (PSP) 會將加密酬載中的付款資訊對應至專屬權杖 (例如「商家權杖」或「客戶個人資料 ID」)。所有交易後互動和資金流動，都完全由你和 PSP 管理。
動態定價如何與商家發起的交易搭配運作？
目前商家發起的交易 (MIT) 不支援動態定價。這是已知限制。
在 WebView 中使用 Google Pay 時，需要哪些內容安全政策 (CSP) 設定？

如果您使用內容安全政策 (CSP)，請務必為 connect-src 指令設定正確的值，允許在 WebView 中使用 Google Pay。例如：

Content-Security-Policy: connect-src pay.google.com google.com account.google.com www.google.com
如何搭配 Google Pay 網頁 API 使用內容安全政策 (CSP) 隨機數？

如果網站強制執行嚴格的 CSP，要求指令碼執行和動態插入樣式必須使用 Nonce：

  1. 在載入 pay.js 的 <script> 標記中加入 CSP nonce 屬性：

    <script
  async
  src="https://pay.google.com/gp/p/js/pay.js"
  nonce="your-nonce-value"
  onload="onGooglePayLoaded()">
</script>

  2. 在例項化 PaymentsClient 時，傳遞 PaymentOptions 中的 nonce 屬性：

    const paymentsClient = new google.payments.api.PaymentsClient({
  environment: 'TEST',
  nonce: 'your-nonce-value'
});

Google Pay 會將這個 nonce 屬性套用至所有動態插入的 <style> 和 <script> 元素，包括由 createButton() 建立的按鈕樣式。

Google Pay API 在結帳時是否會使用或需要 NID Cookie？

不會。NID Cookie 不會用於 Google Pay API 結帳程序，也不支援該程序。

NID Cookie 與 Google 伺服器端服務相關聯，用於儲存未登入 Google 帳戶的使用者個人化資料。

基本服務功能 (包括安全性、防範詐欺和服務可靠性) 的運作與 NID Cookie 無關。無論是否有這個 Cookie，Google Pay API 都能為商家和使用者提供安全可靠的體驗。

Google 致力於保護隱私權，並確保這些 Cookie 的處理方式符合 Google 的《隱私權政策》和《技術與 Cookie 政策》。這些資源有助於您準備法規遵循文件，並向使用者提供更透明的資訊。