MCP Tools Reference: paydeveloper.googleapis.com

工具：create_merchant

使用经过身份验证的账号创建一个新商家。您必须要求用户提供创建商家所需的必要信息。其中一个必填字段是商家类别代码 (MCC)。由于 MCC 列表很长，您可以显示一部分常用选项，但必须告知用户还有更多选项，并且他们可以要求查看完整列表（例如，显示“还有 X 个选项”或类似提示）。此外，还要告知用户，如果他们已经知道 4 位数 MCC 代码（例如 5499），可以直接提供该代码，并鼓励他们使用该代码。在尝试收集创建商家所需的必要信息之前，请勿调用此工具。创建商家后，您必须向用户显示商家控制台服务条款网址，并指示他们接受该条款，然后才能对该商家执行任何操作。

以下代码示例展示了如何使用 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

商家的商家类别代码 (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

已创建商家的商家 ID。
state

enum (State)

已创建商家的状态。
businessConsoleTosUrl

string

仅限输出。商家控制台服务条款网址。用户必须接受商家控制台服务条款，然后才能对商家执行任何操作。

州

商家的状态。

枚举
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，则该工具只能与内部实体互动。例如，网络搜索工具属于开放世界，而内存工具则不属于开放世界。

破坏性提示：❌ | 等幂性提示：❌ | 只读提示：❌ | 开放世界提示：❌