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

商家的状态。

枚举
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

商家的状态。

枚举
STATE_UNSPECIFIED 商家状态未指定。
VERIFIED 商家已通过验证和批准。
IN_REVIEW 商家资料修改正在审核中。
REJECTED 商家资料修改被拒。
INCOMPLETE_SIGNUP 商家资料不完整。
SANCTIONS_HIT 商家资料违反制裁规定。
READY_FOR_REVIEW 商家资料已完成，可以进行审核。
DISABLED 商家资料已停用/无效。

工具注释

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