常見問題

本頁面提供 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 和/或網頁的「發布整合項目」頁面。
如何得知整合提交狀態，以及是否需要在審查程序後進行任何變更？
提交 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，以及如何處理這兩者？
assuranceDetails 物件的設計目的，是協助商家判斷交易是否需要透過 3D Secure 進行驗證，以符合嚴格客戶驗證 (SCA) 規定，而非嚴格區分 DPAN 與 FPAN。如要接收這些詳細資料，商家必須在 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 責任轉移」。
如何辨識先買後付 (BNPL) 交易？
目前沒有先買後付交易的專屬 ID。系統會將這些憑證視為一般 FPAN 憑證。
Google 是否能提供測試卡片，用於測試 SCA 情境？
Google Pay API 無法直接提供任何嚴格客戶驗證測試卡片。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
如何搭配使用內容安全政策 (CSP) Nonce 和 Google Pay Web API？

如果網站強制執行嚴格的 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 會將這個隨機值屬性套用至所有動態插入的 <style> 和 <script> 元素，包括 createButton() 建立的按鈕樣式。

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

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

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

重要服務功能 (包括安全性、防詐欺和服務可靠性) 的運作不受 NID Cookie 影響。無論是否有這個 Cookie，Google Pay API 的設計宗旨都是為商家和使用者提供安全可靠的體驗。

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