MCP Tools Reference: paydeveloper.googleapis.com

工具：create_google_pay_integration

為特定商家建立 Google Pay 整合。這項作業需要使用者接受商家主控台服務條款和 Google Pay API 服務條款。您不需要預先檢查這些項目。如果尚未接受，工具呼叫就會失敗，且錯誤訊息會包含需要接受的特定服務條款網址。如果發生這種情況，請向使用者顯示網址以供接受，並指示他們接受後再試一次。請按照下列順序與使用者互動，再呼叫工具：1. 首先，請使用者提供整合項目 (目前僅支援網站整合)。- 要求提供網站網址。# - If the integration item is App integration, ask for the Android app package name. 2. 接著，請使用者選擇整合類型：- 如果使用者採用我們支援的付款服務供應商 (PSP：https://developers.google.com/pay/api#participating-processors)，請選擇「閘道」；否則請選擇「直接」。3. 所有整合類型 (直接或閘道)： - 請使用者上傳已整合 Google Pay API 的購買流程螢幕截圖 (大小上限為 1 MB)。購買流程必須先通過審查並獲得核准，才能取得完整正式版權限。範例：https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together。 - 你「必須」要求使用者提供 5 張佐證螢幕截圖。請逐一要求，確保對應正確。提問時，請「只」使用簡單易懂的列舉說明。4. 如果整合類型為「直接」： - 你也必須要求使用者提供 PDF 格式的 PCI 認證文件。提問時，請「只」使用易於理解的列舉說明。5. 請使用者提供每個檔案的文件路徑或名稱 (如果檔案位於目前目錄中)。將其對應至正確的 DocumentType，並在要求中將名稱欄位設為描述性名稱 (例如 item_selection.png 或 pci_attestation.pdf)。請先嘗試收集所選整合類型所需的檔案，再呼叫這項工具。

下列範例示範如何使用 curl 叫用 create_google_pay_integration MCP 工具。

Curl 要求 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "create_google_pay_integration",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

輸入內容的結構定義

CreateGooglePayIntegration 的要求訊息。

CreateGooglePayIntegrationRequest

JSON 表示法 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
欄位
merchantId

string

必填。要新增 Google Pay 整合功能的商家商家 ID。
googlePayIntegration

object (GooglePayIntegration)

必填。要建立的 Google Pay 整合。

GooglePayIntegration

JSON 表示法 
{
  "integrationState": enum (IntegrationState),
  "createTime": string,
  "updateTime": string,
  "integrationType": enum (IntegrationType),
  "integrationDocuments": [
    {
      object (IntegrationDocument)
    }
  ],

  // Union field item can be only one of the following:
  "webDomain": string,
  "androidAppPackage": string
  // End of list of possible types for union field item.
}
欄位
integrationState

enum (IntegrationState)

僅供輸出。商家的 Google Pay 整合狀態。
createTime

string (Timestamp format)

僅供輸出。整合資源的建立時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

僅供輸出。整合資源的上次更新時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
integrationType

enum (IntegrationType)

必填。Google Pay 整合的整合類型。
integrationDocuments[]

object (IntegrationDocument)

必填。僅供輸入。Google Pay 整合的整合文件。
聯集欄位 item。整合項目。必須設定其中一個。item 只能是下列其中一項：
webDomain

string

商家的網域。
androidAppPackage

string

商家的 Android 應用程式套件名稱。

時間戳記

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
欄位
seconds

string (int64 format)

代表自 Unix 紀元 1970-01-01T00:00:00Z 起算的世界標準時間秒數。必須介於 -62135596800 和 253402300799 之間 (含)，對應至 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z。
nanos

integer

以奈秒為單位的非負秒數小數。這個欄位是時間長度的奈秒部分，並非秒數的替代值。如果第二個值為負數，且包含分數，奈秒值仍須為非負數，且時間會往前計算。必須介於 0 至 999,999,999 之間 (含)。

IntegrationDocument

JSON 表示法 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
欄位
name

string

必填。文件的名稱。
data

string (bytes format)

必填。文件的資料。

Base64 編碼字串。
documentType

enum (DocumentType)

必填。文件類型。
mimeType

enum (MimeType)

必填。文件的 MIME 類型。

IntegrationState

商家網域或 Android 應用程式的 Google Pay 整合狀態。

列舉
INTEGRATION_STATE_UNSPECIFIED 未指定整合狀態。
NOT_STARTED 如果 Android 應用程式與開發人員 (在 Play 商店中) 相關聯，但開發人員尚未開始任何整合程序，就會處於這個狀態。
INCOMPLETE 開發人員尚未將整合功能送交審查，且整合功能尚未完成 (例如缺少支援文件)。
READY_FOR_REVIEW 開發人員尚未將整合功能送審，但已準備好接受審查 (例如已上傳支援文件)。
UNDER_REVIEW 系統管理員正在審查整合啟用要求。
NEED_INFO 審查期間，gTech 管理員需要提供更多整合資訊。
ACTIVE 整合功能目前已啟用。
DELETED 商家已刪除整合服務。
REJECTED 整合遭拒。

IntegrationType

Google Pay 整合的整合類型。

列舉
INTEGRATION_TYPE_UNSPECIFIED 未指定整合類型。
DIRECT_INTEGRATION 整合類型為直接整合。
PAYMENT_SERVICE_PROVIDER 整合類型為付款服務供應商。

DocumentType

文件類型。

列舉
DOCUMENT_TYPE_UNSPECIFIED 未指定文件類型。
ITEM_SELECTION_SCREENSHOT 使用者瀏覽項目或服務時。
PRE_PURCHASE_SCREENSHOT 使用者最終準備好購物時。
PAYMENT_METHOD_SCREENSHOT 使用者選取 Google Pay 做為付款方式時。
PAYMENT_INFO_SCREENSHOT 向使用者顯示他們儲存在 Google Pay 的付款資訊。提示：Android 不允許擷取這個畫面的螢幕截圖，因此請使用其他裝置拍攝這個畫面。
POST_PURCHASE_SCREENSHOT 使用者成功完成購買交易時。
PCI_ATTESTATION_DOCUMENT PDF 格式的 PCI 認證文件。

MimeType

文件的 MIME 類型。

列舉
MIME_TYPE_UNSPECIFIED 未指定 MIME 類型。
JPEG MIME 類型為 JPEG。
PNG MIME 類型為 PNG。
WEBP MIME 類型為 WEBP。
PDF MIME 類型為 PDF。

輸出內容的結構定義

CreateGooglePayIntegration 的回應訊息。

CreateGooglePayIntegrationResponse

JSON 表示法 
{
  "integrationState": enum (IntegrationState)
}
欄位
integrationState

enum (IntegrationState)

Google Pay 整合的整合狀態。

IntegrationState

商家網域或 Android 應用程式的 Google Pay 整合狀態。

列舉
INTEGRATION_STATE_UNSPECIFIED 未指定整合狀態。
NOT_STARTED 如果 Android 應用程式與開發人員 (在 Play 商店中) 相關聯，但開發人員尚未開始任何整合程序，就會處於這個狀態。
INCOMPLETE 開發人員尚未將整合功能送交審查，且整合功能尚未完成 (例如缺少支援文件)。
READY_FOR_REVIEW 開發人員尚未將整合功能送審，但已準備好接受審查 (例如已上傳支援文件)。
UNDER_REVIEW 系統管理員正在審查整合啟用要求。
NEED_INFO 審查期間，gTech 管理員需要提供更多整合資訊。
ACTIVE 整合功能目前已啟用。
DELETED 商家已刪除整合服務。
REJECTED 整合遭拒。

工具註解

破壞性提示：❌ | 等冪提示：❌ | 唯讀提示：❌ | 開放世界提示：❌