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

僅供輸出。商家的專屬 ID。
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 商家設定檔已停用/無效。

工具註解

破壞性提示：❌ | 等冪提示：❌ | 唯讀提示：❌ | 開放世界提示：❌