MCP Tools Reference: paydeveloper.googleapis.com

Инструмент: create_merchant

Создает нового продавца с авторизованной учетной записью. Вы ОБЯЗАТЕЛЬНО должны запросить у пользователя необходимую информацию для создания продавца. Одним из обязательных полей является код категории продавца (MCC). Поскольку список кодов MCC длинный, вы можете показать подмножество распространенных вариантов, но вы ОБЯЗАТЕЛЬНО должны сообщить пользователю, что доступны и другие варианты, и он может запросить полный список (например, показав «X дополнительных вариантов» или аналогичную подсказку). Кроме того, сообщите пользователю, что он может напрямую ввести 4-значный код MCC (например, 5499), если он его уже знает, и порекомендуйте ему использовать его. Не вызывайте этот инструмент, пока не попытаетесь собрать необходимую информацию для создания продавца. После создания продавца вы ОБЯЗАТЕЛЬНО должны показать пользователю URL-адрес Условий использования Business Console и попросить его принять их, прежде чем он сможет выполнять какие-либо операции с этим продавцом.

Приведённый ниже пример кода демонстрирует, как использовать curl для вызова инструмента create_merchant MCP.

Запрос 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
}'

Схема ввода

Запрос сообщения для CreateMerchant.

CreateMerchantRequest

JSON-представление 
{
  "merchant": {
    object (Merchant)
  }
}
Поля
merchant

object ( Merchant )

Обязательно. Основные данные продавца для создания учетной записи.

Торговец

JSON-представление 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Поля
merchantId

string

Только для вывода. Уникальный идентификатор продавца.

displayName

string

Обязательно. Отображаемое название продавца.

regionCode

string

Обязательно. Код региона местонахождения торговой точки. Формат — коды регионов Unicode CLDR, например, "US". Индия ("IN") не поддерживается.

mcc

enum ( Mcc )

Обязательно. Код категории продавца (MCC).

corporateWebsiteUrl

string

Обязательно. Корпоративный веб-сайт продавца.

customerSupportWebsiteUrl

string

Обязательно. Веб-сайт службы поддержки клиентов продавца.

customerSupportEmail

string

Обязательно. Адрес электронной почты службы поддержки продавца.

customerSupportPhone

string

Обязательно. Номер телефона службы поддержки клиентов продавца.

state

enum ( State )

Только вывод. Состояние продавца.

Макк

Код категории продавца (MCC).

Перечисления
OTHERS Другие
MISC_FOOD_STORES Различные продуктовые магазины – магазины шаговой доступности и специализированные рынки
MISC_APPAREL Различные магазины одежды и аксессуаров
ARTISTS_SUPPLY Магазины товаров для художников и ремесленных принадлежностей
AUTOMOTIVE_PARTS Магазины автозапчастей и аксессуаров
HEALTH_AND_BEAUTY Магазин товаров для здоровья и красоты
BOOKS_PERIODICALS Книги, периодические издания и газеты
CAMERA_STORES Магазины фототехники и фототоваров
COMPUTERS_EQUIPMENT Компьютеры, компьютерная периферия, программное обеспечение
COMPUTER_SOFTWARE Магазины компьютерного программного обеспечения
ELECTRONICS_SALES Продажа электроники
GIFT_SHOPS Магазины открыток, сувениров, товаров для дома и подарков.
EATING_PLACES Заведения общественного питания и рестораны
MISC_GENERAL_MERCHANDISE Разные товары общего назначения
HOME_SUPPLY Магазины товаров для дома и склады
COMPUTER_NETWORK_SERVICES Услуги компьютерных сетей
DIGITAL_GOODS_MEDIA Цифровые товары: книги, фильмы, музыка.
DIGITAL_GOODS_GAMES Цифровые товары: Игры
DIGITAL_GOODS_APPLICATIONS Цифровые товары: Приложения (исключая игры)
POLITICAL_ORGANIZATIONS Политические организации
CHARITABLE_ORGANIZATIONS Благотворительные и социальные организации
DRUG_STORES Аптеки и магазины лекарств
REAL_ESTATE_RENTALS Агенты и управляющие недвижимостью - Аренда
MISC_PERSONAL_SERVICES Различные личные услуги, не классифицированные в других разделах.
SPORTING_GOODS Магазины спортивных товаров
STATIONERY_OFFICE_SUPPLIES Канцелярские товары, офисные принадлежности, бумага для печати и письма.
THEATRICAL_TICKET_AGENCIES Театральные билетные агентства
TIMESHARES Таймшеры
TOURIST_ATTRACTIONS Туристические достопримечательности и экспонаты
HOBBY_TOY_GAME_SHOPS Магазины товаров для хобби, игрушек и настольных игр
PET_SHOPS Зоомагазины, магазины кормов и товаров для животных
OTHER_LODGING Другие варианты размещения – отели, мотели, курорты
TELECOMMUNICATION_SERVICES Телекоммуникационные услуги
TRANSPORTATION_SERVICES Транспортные услуги
OTHER_AIRLINES Другие авиакомпании
TRAVEL_AGENCIES Туристические агентства и туроператоры
GOVERNMENT_OWNED_LOTTERIES_US Государственные лотереи (только для региона США)
GOVERNMENT_LICENSED_CASINOS_US Онлайн-казино, имеющие государственную лицензию (азартные игры в интернете) (только для региона США)
BETTING Ставки (включая лотерейные билеты, фишки для азартных игр в казино, ставки вне ипподрома и пари)
GOVERNMENT_OWNED_LOTTERIES_NON_US Государственные лотереи (за пределами США)

Состояние

Состояние торговца.

Перечисления
STATE_UNSPECIFIED Государство, к которому относится торговый объект, не указано.
VERIFIED Продавец проверен и одобрен.
IN_REVIEW Редактирование профиля продавца находится на рассмотрении.
REJECTED Редактирование профиля продавца отклонено.
INCOMPLETE_SIGNUP Профиль продавца неполный.
SANCTIONS_HIT Профиль продавца попал под санкции.
READY_FOR_REVIEW Профиль продавца заполнен и готов к проверке.
DISABLED Профиль продавца отключен/неактивен.

Схема вывода

Ответное сообщение для CreateMerchant.

CreateMerchantResponse

JSON-представление 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
Поля
merchantId

string

Идентификатор созданного продавца.

state

enum ( State )

Состояние созданного торговца.

businessConsoleTosUrl

string

Только для вывода. URL-адрес Условий использования бизнес-консоли. Пользователь должен принять Условия использования бизнес-консоли, прежде чем сможет выполнять какие-либо операции с продавцом.

Состояние

Состояние торговца.

Перечисления
STATE_UNSPECIFIED Государство, к которому относится торговый объект, не указано.
VERIFIED Продавец проверен и одобрен.
IN_REVIEW Редактирование профиля продавца находится на рассмотрении.
REJECTED Редактирование профиля продавца отклонено.
INCOMPLETE_SIGNUP Профиль продавца неполный.
SANCTIONS_HIT Профиль продавца попал под санкции.
READY_FOR_REVIEW Профиль продавца заполнен и готов к проверке.
DISABLED Профиль продавца отключен/неактивен.

Аннотации инструментов

Аннотации к инструментам отправляются клиентам MCP для описания основных рисков, связанных с данным инструментом. Большинство клиентов считают эти подсказки недостоверными, но они могут использоваться для определения момента отправки пользователю запроса на подтверждение.

Наряду со строкой заголовка, определены следующие логические подсказки:

  • readOnlyHint : Если true, инструмент не изменяет свою среду. По умолчанию: false.
  • destructiveHint : Если true, то инструмент может выполнять деструктивные действия. Если false, то инструмент может выполнять только аддитивные действия. По умолчанию: true.
  • idempotentHint : Если true, то многократный вызов инструмента с одними и теми же аргументами не окажет дополнительного влияния на его окружение. По умолчанию: false.
  • openWorldHint : Если true, то инструмент может взаимодействовать с «открытым миром» внешних объектов. Если false, то инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет представлять собой открытый мир, а инструмент для работы с памятью — нет.

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ❌ | Подсказка только для чтения: ❌ | Подсказка об открытом мире: ❌