MCP Tools Reference: paydeveloper.googleapis.com

Tool: create_merchant

Erstellt einen neuen Händler mit dem authentifizierten Konto. Sie MÜSSEN den Nutzer bitten, die erforderlichen Informationen für die Händlererstellung anzugeben. Eines der Pflichtfelder ist der Händlerkategoriecode (Merchant Category Code – MCC). Da die Liste der MCCs lang ist, können Sie eine Teilmenge der gängigen Optionen präsentieren. Sie MÜSSEN den Nutzer jedoch darüber informieren, dass weitere Optionen verfügbar sind und er die vollständige Liste anfordern kann (z. B. durch die Anzeige von „X weitere Optionen“ oder einem ähnlichen Hinweis). Informiere den Nutzer außerdem, dass er den vierstelligen MCC-Code (z.B. 5499) direkt angeben kann, wenn er ihn bereits kennt, und ermutige ihn, dies zu tun. Rufen Sie dieses Tool erst auf, wenn Sie versucht haben, die erforderlichen Informationen für die Händlererstellung zu erfassen. Nachdem der Händler erstellt wurde, MÜSSEN Sie dem Nutzer die URL der Nutzungsbedingungen der Business Console präsentieren und ihn auffordern, diese zu akzeptieren, bevor er Vorgänge für diesen Händler ausführen kann.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool create_merchant 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_merchant",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für CreateMerchant.

CreateMerchantRequest

JSON-Darstellung 
{
  "merchant": {
    object (Merchant)
  }
}
Felder
merchant

object (Merchant)

Erforderlich. Die grundlegenden Informationen des zu erstellenden Händlers.

Händler

JSON-Darstellung 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Felder
merchantId

string

Nur Ausgabe. Die eindeutige Kennung des Händlers.
displayName

string

Erforderlich. Der Anzeigename des Händlers.
regionCode

string

Erforderlich. Der Ländercode des Standorts des Händlers. Das Format entspricht den Unicode CLDR-Regionscodes, z.B. „US“. Indien („IN“) wird nicht unterstützt.
mcc

enum (Mcc)

Erforderlich. Der Händlerkategoriecode (Merchant Category Code – MCC) des Händlers.
corporateWebsiteUrl

string

Erforderlich. Die Unternehmenswebsite des Händlers.
customerSupportWebsiteUrl

string

Erforderlich. Die Kundensupportwebsite des Händlers.
customerSupportEmail

string

Erforderlich. Die E‑Mail-Adresse des Kundensupports des Händlers.
customerSupportPhone

string

Erforderlich. Die Telefonnummer des Kundensupports des Händlers.
state

enum (State)

Nur Ausgabe. Der Status des Händlers.

Mcc

Der Händlerkategoriecode (Merchant Category Code – MCC) eines Händlers.

Enums
OTHERS Sonstiges
MISC_FOOD_STORES Sonstige Lebensmittelgeschäfte – Minimärkte und Fachmärkte
MISC_APPAREL Verschiedene Bekleidungs- und Accessoireläden
ARTISTS_SUPPLY Geschäfte für Künstlerbedarf und Bastelbedarf
AUTOMOTIVE_PARTS Geschäfte für Kfz-Teile und -Zubehör
HEALTH_AND_BEAUTY Laden für Gesundheits- und Schönheitsprodukte
BOOKS_PERIODICALS Bücher, Zeitschriften und Zeitungen
CAMERA_STORES Kamera- und Fotogeschäfte
COMPUTERS_EQUIPMENT Computer, Computer-Peripheriegeräte, Software
COMPUTER_SOFTWARE Geschäfte für Computersoftware
ELECTRONICS_SALES Verkauf von Elektronikartikeln
GIFT_SHOPS Kartenläden, Geschenkartikel-, Neuheiten- und Souvenirläden
EATING_PLACES Gastronomie und Restaurants
MISC_GENERAL_MERCHANDISE Sonstige Handelsartikel
HOME_SUPPLY Großmärkte für Haushaltswaren
COMPUTER_NETWORK_SERVICES Computernetzwerkdienste
DIGITAL_GOODS_MEDIA Digitale Waren: Bücher, Filme, Musik
DIGITAL_GOODS_GAMES Digitale Waren: Spiele
DIGITAL_GOODS_APPLICATIONS Digitale Waren: Apps (ohne Spiele)
POLITICAL_ORGANIZATIONS Politische Organisationen
CHARITABLE_ORGANIZATIONS Wohltätigkeits- und Sozialorganisationen
DRUG_STORES Drogerien und Apotheken
REAL_ESTATE_RENTALS Immobilienmakler und -verwalter – Vermietung
MISC_PERSONAL_SERVICES Sonstige persönliche Dienstleistungen, anderweitig nicht klassifiziert
SPORTING_GOODS Sportartikelgeschäfte
STATIONERY_OFFICE_SUPPLIES Schreibwaren, Bürobedarf, Druck- und Schreibpapier
THEATRICAL_TICKET_AGENCIES Theaterkartenagenturen
TIMESHARES Timeshare-Anteile
TOURIST_ATTRACTIONS Sehenswürdigkeiten und Ausstellungen
HOBBY_TOY_GAME_SHOPS Hobby-, Spielzeug- und Spieleläden
PET_SHOPS Tierhandlungen, Geschäfte für Haustiernahrung und ‑zubehör
OTHER_LODGING Sonstige Unterkünfte – Hotels, Motels, Resorts
TELECOMMUNICATION_SERVICES Telekommunikationsdienste
TRANSPORTATION_SERVICES Transportdienste
OTHER_AIRLINES Andere Fluggesellschaften
TRAVEL_AGENCIES Reisebüros und Reiseveranstalter
GOVERNMENT_OWNED_LOTTERIES_US Staatliche Lotterien (nur USA)
GOVERNMENT_LICENSED_CASINOS_US Von der Regierung lizenzierte Onlinecasinos (Online-Glücksspiel) (nur USA)
BETTING Wetten (einschließlich Lotterielose, Casinospielchips, Pferdewetten und Wetteinsätze)
GOVERNMENT_OWNED_LOTTERIES_NON_US Staatliche Lotterien (außerhalb der USA)

Bundesland

Der Zustand eines Kaufmanns.

Enums
STATE_UNSPECIFIED Der Händlerstatus ist nicht angegeben.
VERIFIED Der Händler ist verifiziert und genehmigt.
IN_REVIEW Die Bearbeitung des Händlerprofils wird überprüft.
REJECTED Die Änderung des Händlerprofils wird abgelehnt.
INCOMPLETE_SIGNUP Das Händlerprofil ist unvollständig.
SANCTIONS_HIT Das Händlerprofil verstößt gegen Sanktionen.
READY_FOR_REVIEW Das Händlerprofil ist vollständig und kann überprüft werden.
DISABLED Das Händlerprofil ist deaktiviert oder inaktiv.

Ausgabeschema

Antwortnachricht für CreateMerchant.

CreateMerchantResponse

JSON-Darstellung 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
Felder
merchantId

string

Die Händler-ID des erstellten Händlers.
state

enum (State)

Der Zustand des erstellten Händlers.
businessConsoleTosUrl

string

Nur Ausgabe. Die URL der Nutzungsbedingungen für die Business Console. Der Nutzer muss die Nutzungsbedingungen der Business Console akzeptieren, bevor er Aktionen für den Händler ausführen kann.

Bundesland

Der Zustand eines Kaufmanns.

Enums
STATE_UNSPECIFIED Der Händlerstatus ist nicht angegeben.
VERIFIED Der Händler ist verifiziert und genehmigt.
IN_REVIEW Die Bearbeitung des Händlerprofils wird überprüft.
REJECTED Die Änderung des Händlerprofils wird abgelehnt.
INCOMPLETE_SIGNUP Das Händlerprofil ist unvollständig.
SANCTIONS_HIT Das Händlerprofil verstößt gegen Sanktionen.
READY_FOR_REVIEW Das Händlerprofil ist vollständig und kann überprüft werden.
DISABLED Das Händlerprofil ist deaktiviert oder inaktiv.

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.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Hinweis „Nur lesen“: ❌ | Hinweis „Offene Welt“: ❌