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. 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.

Im folgenden Beispiel wird gezeigt, 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 tool's MCP 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 sind die 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 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 Kartengeschäfte, 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 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ücksspiele) (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 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.

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 Status des erstellten Händlers.

businessConsoleTosUrl

string

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

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

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