MCP Tools Reference: paydeveloper.googleapis.com

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

Создает нового продавца с аутентифицированным аккаунтом. Вы ОБЯЗАНЫ запросить у пользователя информацию, необходимую для создания профиля продавца. Одно из обязательных полей – код категории продавца. Поскольку список центров клиентов длинный, вы можете показывать подмножество распространенных вариантов, но вы ДОЛЖНЫ сообщить пользователю, что доступны другие варианты и он может запросить полный список (например, показав "Ещё X вариантов" или аналогичную подсказку). Также сообщите пользователю, что он может указать четырехзначный код 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

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

enum (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 условий использования Business Console. Пользователь должен принять Условия использования Business Console, прежде чем выполнять какие-либо действия с профилем продавца.

Штат

Статус продавца.

Перечисления
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, инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет открытым миром, а инструмент памяти – нет.

Деструктивный подсказка: ❌ | Идемпотентный подсказка: ❌ | Подсказка "Только чтение": ❌ | Подсказка "Открытый мир": ❌