MCP Tools Reference: paydeveloper.googleapis.com

工具：create_google_pay_integration

为特定商家创建 Google Pay 集成。此操作要求用户已接受商家控制台服务条款和 Google Pay API 服务条款。您无需提前检查这些条款。如果用户尚未接受这些条款，工具调用将失败，并且错误消息将包含需要接受的特定服务条款网址。如果发生这种情况，请向用户显示这些网址，以便用户接受，并指示用户在接受后重试。在调用该工具之前，请按照以下顺序与用户互动：1. 首先，询问用户集成项（目前仅支持 Web 集成）。 - 询问网站网址。 - 如果集成项是应用集成，请询问 Android 应用软件包名称。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，并在请求中将 name 字段设置为描述性名称（例如 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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

商家的 Web 网域。
androidAppPackage

string

商家的 Android 应用包名称。

时间戳

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
字段
seconds

string (int64 format)

表示世界协调时间 (UTC) 的秒数（从 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

商家 Web 网域或 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

商家 Web 网域或 Android 应用的 Google Pay 集成状态。

枚举
INTEGRATION_STATE_UNSPECIFIED 集成状态未指定。
NOT_STARTED 此状态适用于 Android 应用与开发者（在 Play 商店中）相关联，但开发者尚未为其启动任何集成流程的情况。
INCOMPLETE 开发者尚未提交集成以供审核，并且集成也不完整（例如缺少支持性文档）。
READY_FOR_REVIEW 开发者尚未提交集成以供审核，但集成已准备好接受审核（例如已上传支持性文档）。
UNDER_REVIEW 集成启用请求待管理员审核。
NEED_INFO 在审核期间，集成需要 gTech 管理员提供更多信息。
ACTIVE 集成目前处于有效状态。
DELETED 集成已被商家删除。
REJECTED 集成被拒绝。

工具注释

破坏性提示：❌ | 等幂性提示：❌ | 只读提示：❌ | 开放世界提示：❌