MCP Tools Reference: paydeveloper.googleapis.com

Tool: list_google_pay_integrations

Gibt den aktuellen Status und die Konfigurationsdetails für alle Google Pay-Integrationen zurück, die einer bestimmten Händler-ID zugeordnet sind. Sie erhalten sofortiges Feedback zum Status der Integration und der Dokumentprüfungen. Außerdem MÜSSEN Sie den Nutzer darüber informieren, dass die Integration in der Google Pay & Wallet Console (https://pay.google.com/business/console/) erstellt bzw. aktualisiert werden kann.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool list_google_pay_integrations aufrufen.

Curl-Anfrage 
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
}'

Eingabeschema

Anfragenachricht zum Auflisten von Google Pay-Integrationen für einen bestimmten Händler.

ListGooglePayIntegrationsRequest

JSON-Darstellung 
{
  "merchantId": string
}
Felder
merchantId

string

Erforderlich. Die Händler-ID, für die Integrationen aufgelistet werden sollen.

Ausgabeschema

Antwortnachricht für die Auflistung von Google Pay-Integrationen.

ListGooglePayIntegrationsResponse

JSON-Darstellung 
{
  "googlePayIntegrations": [
    {
      object (GooglePayIntegration)
    }
  ]
}
Felder
googlePayIntegrations[]

object (GooglePayIntegration)

Die Google Pay-Integrationen des Händlers.

GooglePayIntegration

JSON-Darstellung 
{
  "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.
}
Felder
integrationState

enum (IntegrationState)

Nur Ausgabe. Der Google Pay-Integrationsstatus des Händlers.
createTime

string (Timestamp format)

Nur Ausgabe. Wann die Integrationsressource erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Wann die Integrationsressource zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
integrationType

enum (IntegrationType)

Erforderlich. Der Integrationstyp der Google Pay-Integration.
integrationDocuments[]

object (IntegrationDocument)

Erforderlich. Nur Eingabe. Die Integrationsdokumente der Google Pay-Integration.
Union-Feld item. Das Integrationselement. Einer dieser Werte muss festgelegt werden. Für item ist nur einer der folgenden Werte zulässig:
webDomain

string

Die Webdomain des Händlers.
androidAppPackage

string

Der Android-App-Paketname des Händlers.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

IntegrationDocument

JSON-Darstellung 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
Felder
name

string

Erforderlich. Der Name des Dokuments.
data

string (bytes format)

Erforderlich. Die Daten des Dokuments.

Ein base64-codierter String.
documentType

enum (DocumentType)

Erforderlich. Der Typ des Dokuments.
mimeType

enum (MimeType)

Erforderlich. Der MIME-Typ des Dokuments.

IntegrationState

Der Google Pay-Integrationsstatus einer Händlerwebdomain oder Android-App.

Enums
INTEGRATION_STATE_UNSPECIFIED Der Integrationsstatus ist nicht angegeben.
NOT_STARTED Dieser Zustand tritt ein, wenn die Android-App mit dem Entwickler (im Google Play Store) verknüpft ist und der Entwickler noch keinen Integrationsprozess dafür gestartet hat.
INCOMPLETE Der Entwickler hat die Integration noch nicht zur Überprüfung eingereicht und sie ist auch noch nicht vollständig (z.B. fehlen Begleitdokumente).
READY_FOR_REVIEW Der Entwickler hat die Integration noch nicht zur Überprüfung eingereicht, sie ist aber bereit für die Überprüfung (z.B. wurden unterstützende Dokumente hochgeladen).
UNDER_REVIEW Die Anfrage zur Aktivierung der Integration wird derzeit vom Administrator überprüft.
NEED_INFO Für die Integration sind während der Überprüfung weitere Informationen von einem gTech-Administrator erforderlich.
ACTIVE Die Integration ist derzeit aktiv.
DELETED Die Integration wird vom Händler gelöscht.
REJECTED Die Integration wird abgelehnt.

IntegrationType

Der Integrationstyp einer Google Pay-Integration.

Enums
INTEGRATION_TYPE_UNSPECIFIED Der Integrationstyp ist nicht angegeben.
DIRECT_INTEGRATION Der Integrationstyp ist die direkte Integration.
PAYMENT_SERVICE_PROVIDER Der Integrationstyp ist „Zahlungsdienstanbieter“.

DocumentType

Der Typ eines Dokuments.

Enums
DOCUMENT_TYPE_UNSPECIFIED Der Dokumenttyp ist nicht angegeben.
ITEM_SELECTION_SCREENSHOT Wenn ein Nutzer einen Artikel oder eine Dienstleistung ansieht.
PRE_PURCHASE_SCREENSHOT Wenn ein Nutzer bereit ist, einen Kauf zu tätigen.
PAYMENT_METHOD_SCREENSHOT Wenn ein Nutzer Google Pay als Zahlungsmethode auswählt.
PAYMENT_INFO_SCREENSHOT Wenn einem Nutzer die Zahlungsinformationen angezeigt werden, die er in Google Pay gespeichert hat Tipp: Android lässt Sie keinen Screenshot dieses Bildschirms erstellen. Machen Sie daher mit einem anderen Gerät ein Foto des Bildschirms.
POST_PURCHASE_SCREENSHOT Wenn ein Nutzer einen Kauf abgeschlossen hat.
PCI_ATTESTATION_DOCUMENT PCI-Bescheinigung im PDF-Format.

MimeType

Der MIME-Typ eines Dokuments.

Enums
MIME_TYPE_UNSPECIFIED Der MIME-Typ ist nicht angegeben.
JPEG Der MIME-Typ ist JPEG.
PNG Der MIME-Typ ist PNG.
WEBP Der MIME-Typ ist WEBP.
PDF Der MIME-Typ ist „PDF“.

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet wird.

Zusammen mit dem Titelstring sind die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Einheiten interagieren. Wenn „false“, kann das Tool nur mit internen Einheiten interagieren. Ein Web-Suchtool wäre beispielsweise frei verfügbar, ein Memory-Tool jedoch nicht.

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌