MCP Tools Reference: paydeveloper.googleapis.com

工具：list_google_pay_integrations

返回与特定商家 ID 相关联的所有 Google Pay 集成的当前状态和配置详细信息。它会立即提供有关集成状态和文档审核的反馈。此外，您必须告知用户可以在 Google Pay 和 Google 钱包控制台 (https://pay.google.com/business/console/) 中创建/更新集成。

以下代码示例展示了如何使用 curl 调用 list_google_pay_integrations 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": "list_google_pay_integrations",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

输入架构

用于列出特定商家的 Google Pay 集成的请求消息。

ListGooglePayIntegrationsRequest

JSON 表示法 
{
  "merchantId": string
}
字段
merchantId

string

必需。要列出集成的商家 ID。

输出架构

用于列出 Google Pay 集成的响应消息。

ListGooglePayIntegrationsResponse

JSON 表示法 
{
  "googlePayIntegrations": [
    {
      object (GooglePayIntegration)
    }
  ]
}
字段
googlePayIntegrations[]

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。

工具注释

工具注释会发送给 MCP 客户端，用于描述给定工具的基本风险。大多数客户端会将这些提示视为不受信任，但它们可用于确定何时向用户发送确认提示。

除了标题字符串之外，以下布尔提示的定义如下：

  • readOnlyHint：如果为 true，则该工具不会修改其环境。默认值：false。
  • destructiveHint：如果为 true，则该工具可以执行破坏性操作。如果为 false，则该工具只能执行添加操作。默认值：true。
  • idempotentHint：如果为 true，则使用相同的参数重复调用该工具不会对其环境产生额外影响。默认值：false。
  • openWorldHint：如果为 true，则该工具可以与外部实体的“开放世界”进行交互。如果为 false，则该工具只能与内部实体进行交互。例如，Web 搜索工具属于开放世界，而内存工具则不属于开放世界。

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