MCP Tools Reference: paydeveloper.googleapis.com

Tool: create_google_pay_integration

Erstellt eine Google Pay-Integration für einen bestimmten Händler. Für diesen Vorgang muss der Nutzer die Nutzungsbedingungen der Business Console und die Nutzungsbedingungen der Google Pay API akzeptiert haben. Sie müssen nicht im Voraus danach suchen. Wenn sie nicht akzeptiert wurden, schlägt der Tool-Aufruf fehl und die Fehlermeldung enthält die spezifischen URLs der Nutzungsbedingungen, die akzeptiert werden müssen. Wenn dies der Fall ist, präsentieren Sie dem Nutzer die URLs zur Bestätigung und weisen Sie ihn an, es nach der Bestätigung noch einmal zu versuchen. Führen Sie die folgenden Schritte aus, um mit dem Nutzer zu interagieren, BEVOR Sie das Tool aufrufen: 1. Fragen Sie den Nutzer zuerst nach dem Integrationselement (derzeit wird nur die Webintegration unterstützt). – Fragen Sie nach der Website-URL. # – Wenn es sich bei dem Integrationselement um die App-Einbindung handelt, fragen Sie nach dem Paketnamen der Android-App. 2. Fragen Sie den Nutzer dann nach dem Integrationstyp: – Bitten Sie den Nutzer, „Gateway“ auszuwählen, wenn er einen unserer unterstützten Zahlungsdienstleister (Payment Service Providers, PSPs: https://developers.google.com/pay/api#participating-processors) verwendet. Andernfalls soll er „Direkt“ auswählen. 3. Für ALLE Integrationstypen (direkt oder Gateway): – Bitte den Nutzer, Screenshots (max. 1 MB) seines in die Google Pay API integrierten Kaufvorgangs hochzuladen. Der Kaufvorgang muss überprüft und genehmigt werden, damit sie den uneingeschränkten Produktionszugriff erhalten. Beispiele: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. – Du MUSST den Nutzer bitten, fünf unterstützende Screenshots bereitzustellen. Fragen Sie sie EINZELN ab, um eine korrekte Zuordnung zu gewährleisten. Verwende bei Fragen NUR die nutzerfreundlichen Enum-Beschreibungen. 4. Wenn der Integrationstyp „Direkt“ ist: - Sie MÜSSEN den Nutzer AUCH bitten, das PCI-Attest im PDF-Format bereitzustellen. Verwenden Sie NUR die nutzerfreundliche Enum-Beschreibung, wenn Sie eine Frage stellen. 5. Bitten Sie den Nutzer, für jede bereitgestellte Datei den Dokumentpfad oder den Namen anzugeben, wenn sich die Datei im aktuellen Verzeichnis befindet. Ordnen Sie sie dem richtigen DocumentType zu und legen Sie das Namensfeld in der Anfrage auf einen aussagekräftigen Namen fest, z.B. „item_selection.png“ oder „pci_attestation.pdf“. Rufen Sie dieses Tool erst auf, wenn Sie versucht haben, die erforderlichen Dokumente für den ausgewählten Integrationstyp zu sammeln.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool create_google_pay_integration 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": "create_google_pay_integration",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für CreateGooglePayIntegration

CreateGooglePayIntegrationRequest

JSON-Darstellung 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
Felder
merchantId

string

Erforderlich. Die Händler-ID des Händlers, für den die Google Pay-Integration hinzugefügt werden soll.
googlePayIntegration

object (GooglePayIntegration)

Erforderlich. Die zu erstellende Google Pay-Integration.

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 sein. 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 Status wird angezeigt, wenn die Android-App mit dem Entwickler (im Google Play Store) verknüpft ist und der Entwickler noch keinen Integrationsprozess für die App 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 unterstützende Dokumente).
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“.

Ausgabeschema

Antwortnachricht für CreateGooglePayIntegration.

CreateGooglePayIntegrationResponse

JSON-Darstellung 
{
  "integrationState": enum (IntegrationState)
}
Felder
integrationState

enum (IntegrationState)

Der Integrationsstatus der Google Pay-Integration.

IntegrationState

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

Enums
INTEGRATION_STATE_UNSPECIFIED Der Integrationsstatus ist nicht angegeben.
NOT_STARTED Dieser Status wird angezeigt, wenn die Android-App mit dem Entwickler (im Google Play Store) verknüpft ist und der Entwickler noch keinen Integrationsprozess für die App 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 unterstützende Dokumente).
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.

Tool-Annotationen

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