MCP Tools Reference: paydeveloper.googleapis.com

Công cụ: create_merchant

Tạo người bán mới bằng tài khoản đã xác thực. Bạn PHẢI yêu cầu người dùng cung cấp thông tin bắt buộc để tạo người bán. Đừng gọi công cụ này cho đến khi bạn đã cố gắng thu thập thông tin bắt buộc để tạo người bán. Sau khi tạo người bán, BẠN PHẢI cung cấp URL Điều khoản dịch vụ của Business Console cho người dùng và hướng dẫn họ chấp nhận URL này trước khi họ có thể thực hiện bất kỳ thao tác nào trên người bán này.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ MCP create_merchant.

Yêu cầu 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
}'

Giản đồ đầu vào

Thông báo yêu cầu cho CreateMerchant.

CreateMerchantRequest

Biểu diễn dưới dạng JSON 
{
  "merchant": {
    object (Merchant)
  }
}
Trường
merchant

object (Merchant)

Bắt buộc. Thông tin cơ bản về người bán cần tạo.

Người bán

Biểu diễn dưới dạng JSON 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Trường
merchantId

string

Chỉ có đầu ra. Giá trị nhận dạng riêng biệt của người bán.
displayName

string

Bắt buộc. Tên hiển thị của người bán.
regionCode

string

Bắt buộc. Mã khu vực của địa điểm của doanh nghiệp của người bán. Định dạng là mã vùng CLDR Unicode, ví dụ: "US". Ấn Độ ("IN") không được hỗ trợ.
mcc

enum (Mcc)

Bắt buộc. Mã danh mục của người bán (MCC) của người bán.
corporateWebsiteUrl

string

Bắt buộc. Trang web doanh nghiệp của người bán.
customerSupportWebsiteUrl

string

Bắt buộc. Trang web hỗ trợ khách hàng của người bán.
customerSupportEmail

string

Bắt buộc. Email hỗ trợ khách hàng của người bán.
customerSupportPhone

string

Bắt buộc. Số điện thoại của bộ phận hỗ trợ khách hàng của người bán.
state

enum (State)

Chỉ có đầu ra. Tiểu bang của người bán.

Mcc

Mã danh mục của người bán (MCC) của một người bán.

Enum
OTHERS Khác
MISC_FOOD_STORES Cửa hàng thực phẩm khác – Cửa hàng tiện lợi và chợ đặc sản
MISC_APPAREL Cửa hàng quần áo và phụ kiện khác
ARTISTS_SUPPLY Cửa hàng bán đồ dùng cho nghệ sĩ và đồ thủ công
AUTOMOTIVE_PARTS Cửa hàng phụ tùng và phụ kiện ô tô
HEALTH_AND_BEAUTY Cửa hàng chăm sóc sức khỏe và làm đẹp
BOOKS_PERIODICALS Sách, tạp chí và báo
CAMERA_STORES Cửa hàng bán máy ảnh và thiết bị chụp ảnh
COMPUTERS_EQUIPMENT Máy tính, Thiết bị ngoại vi cho máy tính, Phần mềm
COMPUTER_SOFTWARE Cửa hàng phần mềm máy tính
ELECTRONICS_SALES Bán đồ điện tử
GIFT_SHOPS Cửa hàng bán thẻ, quà tặng, đồ mới lạ và đồ lưu niệm
EATING_PLACES Địa điểm ăn uống và nhà hàng
MISC_GENERAL_MERCHANDISE Hàng hoá chung khác
HOME_SUPPLY Cửa hàng bán buôn đồ gia dụng
COMPUTER_NETWORK_SERVICES Dịch vụ mạng máy tính
DIGITAL_GOODS_MEDIA Hàng hoá kỹ thuật số: Sách, Phim, Nhạc
DIGITAL_GOODS_GAMES Hàng hoá kỹ thuật số: Trò chơi
DIGITAL_GOODS_APPLICATIONS Hàng hoá kỹ thuật số: Ứng dụng (Không bao gồm trò chơi)
POLITICAL_ORGANIZATIONS Tổ chức chính trị
CHARITABLE_ORGANIZATIONS Tổ chức từ thiện và tổ chức dịch vụ xã hội
DRUG_STORES Quầy thuốc và hiệu thuốc
REAL_ESTATE_RENTALS Đại lý và người quản lý bất động sản – Cho thuê
MISC_PERSONAL_SERVICES Các dịch vụ cá nhân khác, không được phân loại ở nơi khác
SPORTING_GOODS Cửa hàng đồ thể thao
STATIONERY_OFFICE_SUPPLIES Văn phòng phẩm, Vật tư văn phòng, Giấy in và giấy viết
THEATRICAL_TICKET_AGENCIES Công ty bán vé xem phim
TIMESHARES Chia thời gian
TOURIST_ATTRACTIONS Điểm du lịch và triển lãm
HOBBY_TOY_GAME_SHOPS Cửa hàng đồ chơi, trò chơi và đồ theo sở thích
PET_SHOPS Cửa hàng thú cưng, cửa hàng thức ăn và đồ dùng cho thú cưng
OTHER_LODGING Nơi lưu trú khác – Khách sạn, nhà nghỉ ven đường, khu nghỉ dưỡng
TELECOMMUNICATION_SERVICES Dịch vụ viễn thông
TRANSPORTATION_SERVICES Dịch vụ vận tải
OTHER_AIRLINES Các hãng hàng không khác
TRAVEL_AGENCIES Đại lý du lịch và công ty du lịch
GOVERNMENT_OWNED_LOTTERIES_US Xổ số do chính phủ sở hữu (chỉ ở vùng Hoa Kỳ)
GOVERNMENT_LICENSED_CASINOS_US Sòng bạc trực tuyến được chính phủ cấp phép (Cờ bạc trực tuyến) (Chỉ ở khu vực Hoa Kỳ)
BETTING Cá cược (bao gồm cả Vé số, Phỉnh sòng bạc, Cá cược bên ngoài trường đua và Tiền cược)
GOVERNMENT_OWNED_LOTTERIES_NON_US Xổ số thuộc sở hữu của chính phủ (Khu vực bên ngoài Hoa Kỳ)

Tiểu bang

Trạng thái của người bán.

Enum
STATE_UNSPECIFIED Trạng thái của người bán chưa được chỉ định.
VERIFIED Người bán đã được xác minh và phê duyệt.
IN_REVIEW Nội dung chỉnh sửa hồ sơ người bán đang được xem xét.
REJECTED Nội dung chỉnh sửa trang doanh nghiệp của người bán bị từ chối.
INCOMPLETE_SIGNUP Hồ sơ người bán chưa hoàn chỉnh.
SANCTIONS_HIT Hồ sơ người bán bị ảnh hưởng bởi các lệnh trừng phạt.
READY_FOR_REVIEW Hồ sơ người bán đã hoàn tất và sẵn sàng để xem xét.
DISABLED Hồ sơ người bán bị vô hiệu hoá/không hoạt động.

Giản đồ đầu ra

Thông báo phản hồi cho CreateMerchant.

CreateMerchantResponse

Biểu diễn dưới dạng JSON 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
Trường
merchantId

string

Mã người bán của người bán đã tạo.
state

enum (State)

Trạng thái của người bán đã tạo.
businessConsoleTosUrl

string

Chỉ có đầu ra. URL của Điều khoản dịch vụ trên Business Console. Người dùng phải chấp nhận Điều khoản dịch vụ của Business Console thì mới có thể thực hiện bất kỳ thao tác nào trên người bán.

Tiểu bang

Trạng thái của người bán.

Enum
STATE_UNSPECIFIED Trạng thái của người bán chưa được chỉ định.
VERIFIED Người bán đã được xác minh và phê duyệt.
IN_REVIEW Nội dung chỉnh sửa hồ sơ người bán đang được xem xét.
REJECTED Nội dung chỉnh sửa trang doanh nghiệp của người bán bị từ chối.
INCOMPLETE_SIGNUP Hồ sơ người bán chưa hoàn chỉnh.
SANCTIONS_HIT Hồ sơ người bán bị ảnh hưởng bởi các lệnh trừng phạt.
READY_FOR_REVIEW Hồ sơ người bán đã hoàn tất và sẵn sàng để xem xét.
DISABLED Hồ sơ người bán bị vô hiệu hoá/không hoạt động.

Chú giải công cụ

Gợi ý mang tính huỷ diệt: ❌ | Gợi ý mang tính luỹ đẳng: ❌ | Gợi ý chỉ đọc: ❌ | Gợi ý về thế giới mở: ❌