MCP Tools Reference: paydeveloper.googleapis.com

Tool: update_merchant

Aktualisiert bestimmte Felder eines vorhandenen Händlers. Unterstützte Felder sind unter anderem display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email und customer_support_phone.

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

Eingabeschema

Anfragenachricht für UpdateMerchant

UpdateMerchantFacadeRequest

JSON-Darstellung
{
  "merchantId": string,

  // Union field _display_name can be only one of the following:
  "displayName": string
  // End of list of possible types for union field _display_name.

  // Union field _mcc can be only one of the following:
  "mcc": enum (Mcc)
  // End of list of possible types for union field _mcc.

  // Union field _corporate_website_url can be only one of the following:
  "corporateWebsiteUrl": string
  // End of list of possible types for union field _corporate_website_url.

  // Union field _customer_support_website_url can be only one of the following:
  "customerSupportWebsiteUrl": string
  // End of list of possible types for union field _customer_support_website_url.

  // Union field _customer_support_email can be only one of the following:
  "customerSupportEmail": string
  // End of list of possible types for union field _customer_support_email.

  // Union field _customer_support_phone can be only one of the following:
  "customerSupportPhone": string
  // End of list of possible types for union field _customer_support_phone.
}
Felder
merchantId

string

Erforderlich. Die Händler-ID des Händlers, der aktualisiert werden soll.

Union-Feld _display_name.

Für _display_name ist nur einer der folgenden Werte zulässig:

displayName

string

Der Anzeigename des Händlers.

Union-Feld _mcc.

Für _mcc ist nur einer der folgenden Werte zulässig:

mcc

enum (Mcc)

Der MCC (Merchant Category Code) des Händlers.

Union-Feld _corporate_website_url.

Für _corporate_website_url ist nur einer der folgenden Werte zulässig:

corporateWebsiteUrl

string

Die Unternehmenswebsite des Händlers.

Union-Feld _customer_support_website_url.

Für _customer_support_website_url ist nur einer der folgenden Werte zulässig:

customerSupportWebsiteUrl

string

Die Kundensupportwebsite des Händlers.

Union-Feld _customer_support_email.

Für _customer_support_email ist nur einer der folgenden Werte zulässig:

customerSupportEmail

string

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

Union-Feld _customer_support_phone.

Für _customer_support_phone ist nur einer der folgenden Werte zulässig:

customerSupportPhone

string

Die Telefonnummer des Kundensupports 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 Sonstige Geschäfte für Bekleidung und Accessoires
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 – Vermietungen
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 Verkaufsstellen für Kinotickets
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 Andere 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)

Ausgabeschema

Antwortnachricht für UpdateMerchant

UpdateMerchantResponse

JSON-Darstellung
{
  "state": enum (State)
}
Felder
state

enum (State)

Der Status des aktualisierten Händlers.

Bundesland

Der Status eines Händlers.

Enums
STATE_UNSPECIFIED Der Händlerstatus ist nicht angegeben.
VERIFIED Der Händler ist verifiziert und genehmigt.
IN_REVIEW Die Änderung 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: ✅ | Nur-Lese-Hinweis: ❌ | Open-World-Hinweis: ❌