MCP Tools Reference: paydeveloper.googleapis.com

工具：create_merchant

使用已通过身份验证的账号创建新商家。您必须要求用户提供创建商家所需的必要信息。在尝试收集商家创建所需的信息之前，请勿调用此工具。创建商家后，您必须向用户显示商家控制台服务条款网址，并指示用户接受该条款，然后用户才能对该商家执行任何操作。

以下示例演示了如何使用 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 tool's MCP 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 商家资料已停用/处于非活跃状态。

工具注释

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