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. 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ład pokazuje, jak za pomocą curl wywołać narzędzie 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 tool's MCP 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 działu 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 rękodzielnikó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 Kasyna online z licencją państwową (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 jest 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 jest 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 do narzędzi

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