MCP Tools Reference: paydeveloper.googleapis.com

Narzędzie: create_merchant

Tworzy nowego sprzedawcę na podstawie uwierzytelnionego konta. MUSISZ poprosić użytkownika o podanie wymaganych informacji do utworzenia sprzedawcy. Jednym z wymaganych pól jest kod kategorii sprzedawcy (MCC). Lista kodów MCC jest długa, więc możesz wyświetlić podzbiór typowych opcji, ale MUSISZ poinformować użytkownika, że dostępnych jest więcej opcji i może on poprosić o pełną listę (np. wyświetlając komunikat „X więcej opcji” lub podobną wskazówkę). Poinformuj też użytkownika, że jeśli zna już 4-cyfrowy kod MCC (np.5499), może go podać bezpośrednio. Zachęć go do tego. Nie wywołuj tego narzędzia, dopóki nie spróbujesz zebrać wymaganych informacji do utworzenia sprzedawcy. Po utworzeniu sprzedawcy MUSISZ wyświetlić użytkownikowi adres URL Warunków korzystania z Business Console i poprosić go o ich zaakceptowanie, zanim będzie mógł wykonywać jakiekolwiek operacje na tym sprzedawcy.

Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia create_merchant MCP.

Żądanie curl 
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
}'

Schemat danych wejściowych

Wiadomość z prośbą o utworzenie sprzedawcy.

CreateMerchantRequest

Zapis JSON 
{
  "merchant": {
    object (Merchant)
  }
}
Pola
merchant

object (Merchant)

Wymagane. Podstawowe informacje o sprzedawcy, które należy utworzyć.

Sprzedawca

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

string

Tylko dane wyjściowe. Unikalny identyfikator sprzedawcy.
displayName

string

Wymagane. Wyświetlana nazwa sprzedawcy.
regionCode

string

Wymagane. Kod regionu adresu sklepu sprzedawcy. Format to kody regionów Unicode CLDR, np. „US”. Indie („IN”) nie są obsługiwane.
mcc

enum (Mcc)

Wymagane. Kod kategorii sprzedawcy (MCC).
corporateWebsiteUrl

string

Wymagane. Witryna firmowa sprzedawcy.
customerSupportWebsiteUrl

string

Wymagane. strona obsługi klienta sprzedawcy;
customerSupportEmail

string

Wymagane. Adres e-mail obsługi klienta sprzedawcy.
customerSupportPhone

string

Wymagane. Numer telefonu obsługi klienta sprzedawcy.
state

enum (State)

Tylko dane wyjściowe. Stan sprzedawcy.

MCC

Kod kategorii sprzedawcy (MCC).

Wartości w polu enum
OTHERS Inne
MISC_FOOD_STORES Różne sklepy spożywcze – sklepy osiedlowe i sklepy specjalistyczne
MISC_APPAREL Różne sklepy z odzieżą i akcesoriami
ARTISTS_SUPPLY Sklepy z artykułami dla artystów i rzemieślników
AUTOMOTIVE_PARTS Sklepy z częściami i akcesoriami samochodowymi
HEALTH_AND_BEAUTY Sklep z produktami dla zdrowia i urody
BOOKS_PERIODICALS Książki, czasopisma i gazety
CAMERA_STORES Sklepy z aparatami fotograficznymi i powiązanymi materiałami eksploatacyjnymi
COMPUTERS_EQUIPMENT Komputery, komputerowe urządzenia peryferyjne, oprogramowanie
COMPUTER_SOFTWARE Sklepy z oprogramowaniem komputerowym
ELECTRONICS_SALES Sprzedaż elektroniki
GIFT_SHOPS Sklepy z kartkami, upominkami, nowościami i pamiątkami
EATING_PLACES Lokale gastronomiczne i restauracje
MISC_GENERAL_MERCHANDISE Różne towary
HOME_SUPPLY Sklepy z wyposażeniem domu
COMPUTER_NETWORK_SERVICES Usługi sieci komputerowych
DIGITAL_GOODS_MEDIA Produkty cyfrowe: książki, filmy, muzyka
DIGITAL_GOODS_GAMES Produkty cyfrowe: gry
DIGITAL_GOODS_APPLICATIONS Produkty cyfrowe: aplikacje (z wyjątkiem gier)
POLITICAL_ORGANIZATIONS Organizacje polityczne
CHARITABLE_ORGANIZATIONS Organizacje charytatywne i organizacje pomocy społecznej
DRUG_STORES Drogerie i apteki
REAL_ESTATE_RENTALS Agencje i zarządcy nieruchomości – wynajem
MISC_PERSONAL_SERVICES Różne usługi osobiste niesklasyfikowane w innych miejscach
SPORTING_GOODS Sklepy sportowe
STATIONERY_OFFICE_SUPPLIES Materiały papiernicze i biurowe, papier do drukowania i pisania
THEATRICAL_TICKET_AGENCIES Agencje sprzedaży biletów do teatrów
TIMESHARES Własność współużytkowana
TOURIST_ATTRACTIONS Atrakcje turystyczne i wystawy
HOBBY_TOY_GAME_SHOPS Sklepy z artykułami hobbystycznymi, zabawkami i grami
PET_SHOPS Sklepy zoologiczne, sklepy z karmą i akcesoriami dla zwierząt
OTHER_LODGING Inne miejsca zakwaterowania – hotele, motele, ośrodki wypoczynkowe
TELECOMMUNICATION_SERVICES Usługi telekomunikacyjne
TRANSPORTATION_SERVICES Usługi transportowe
OTHER_AIRLINES Inne linie lotnicze
TRAVEL_AGENCIES Biura podróży i operatorzy wycieczek
GOVERNMENT_OWNED_LOTTERIES_US Loterie państwowe (tylko w Stanach Zjednoczonych)
GOVERNMENT_LICENSED_CASINOS_US Licencjonowane przez rząd kasyna online (hazard online) (tylko w Stanach Zjednoczonych)
BETTING Zakłady (w tym kupony loteryjne, żetony do gier kasynowych, zakłady poza torem wyścigowym i zakłady pieniężne)
GOVERNMENT_OWNED_LOTTERIES_NON_US Loterie państwowe (region spoza Stanów Zjednoczonych)

Stan

Stan sprzedawcy.

Wartości w polu enum
STATE_UNSPECIFIED Stan sprzedawcy jest nieokreślony.
VERIFIED Sprzedawca został zweryfikowany i zatwierdzony.
IN_REVIEW Zmiana w profilu sprzedawcy jest w trakcie sprawdzania.
REJECTED Zmiana w profilu sprzedawcy została odrzucona.
INCOMPLETE_SIGNUP Profil sprzedawcy jest niekompletny.
SANCTIONS_HIT Profil sprzedawcy narusza sankcje.
READY_FOR_REVIEW Profil sprzedawcy jest kompletny i gotowy do sprawdzenia.
DISABLED Profil sprzedawcy jest wyłączony lub nieaktywny.

Schemat wyjściowy

Wiadomość odpowiedzi dla CreateMerchant.

CreateMerchantResponse

Zapis JSON 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
Pola
merchantId

string

Identyfikator utworzonego sprzedawcy.
state

enum (State)

Stan utworzonego sprzedawcy.
businessConsoleTosUrl

string

Tylko dane wyjściowe. Adres URL warunków korzystania z Business Console. Zanim użytkownik będzie mógł wykonywać jakiekolwiek operacje na sprzedawcy, musi zaakceptować Warunki korzystania z konsoli biznesowej.

Stan

Stan sprzedawcy.

Wartości w polu enum
STATE_UNSPECIFIED Stan sprzedawcy jest nieokreślony.
VERIFIED Sprzedawca został zweryfikowany i zatwierdzony.
IN_REVIEW Zmiana w profilu sprzedawcy jest w trakcie sprawdzania.
REJECTED Zmiana w profilu sprzedawcy została odrzucona.
INCOMPLETE_SIGNUP Profil sprzedawcy jest niekompletny.
SANCTIONS_HIT Profil sprzedawcy narusza sankcje.
READY_FOR_REVIEW Profil sprzedawcy jest kompletny i gotowy do sprawdzenia.
DISABLED Profil sprzedawcy jest wyłączony lub nieaktywny.

Adnotacje narzędzi

Adnotacje narzędzia są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich używać do decydowania, kiedy wysłać użytkownikowi prośbę o potwierdzenie.

Oprócz ciągu znaków tytułu zdefiniowano te wskazówki logiczne:

  • readOnlyHint: jeśli wartość jest prawdziwa, narzędzie nie modyfikuje swojego środowiska. Wartość domyślna: fałsz.
  • destructiveHint: jeśli ma wartość Prawda, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość „false”, narzędzie może wykonywać tylko działania addytywne. Wartość domyślna: true.
  • idempotentHint: jeśli wartość to „true”, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Wartość domyślna: fałsz.
  • openWorldHint: jeśli wartość to „true”, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli wartość jest fałszywa, narzędzie może wchodzić w interakcje tylko z podmiotami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie byłoby narzędziem typu otwarty świat, a narzędzie do zapamiętywania nie.

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