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. Một trong các trường bắt buộc là Mã danh mục của người bán (MCC). Vì danh sách MCC rất dài, nên bạn có thể trình bày một nhóm nhỏ các lựa chọn phổ biến, nhưng BẠN PHẢI thông báo cho người dùng rằng có nhiều lựa chọn khác và họ có thể yêu cầu danh sách đầy đủ (ví dụ: bằng cách cho thấy "X lựa chọn khác" hoặc gợi ý tương tự). Ngoài ra, hãy thông báo cho người dùng rằng họ có thể cung cấp trực tiếp mã MCC gồm 4 chữ số (ví dụ: 5499) nếu đã biết và khuyến khích họ sử dụng mã này. Đừng gọi công cụ này cho đến khi bạn đã cố gắng thu thập thông tin cần thiết để 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ã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ create_merchant MCP.

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 MCP tool 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 thương gia (MCC) của thương gia.
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 nhà bán lẻ.
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ác cửa hàng thực phẩm tổng hợp – Cửa hàng tiện lợi và chợ chuyên bán các mặt hàng đặ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 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, đồ lưu niệm và đồ chơi
EATING_PLACES Các quán ăn 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 hóa 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 Chỗ ở 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 thương nhân được tạo ra.
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ụ

Chú thích công cụ được gửi đến các ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết các ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng bạn có thể dùng chúng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.

Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:

  • readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của công cụ. Mặc định: false.
  • destructiveHint: Nếu đúng, công cụ có thể thực hiện các hành động phá huỷ. Nếu là false, thì công cụ chỉ có thể thực hiện các thao tác bổ sung. Mặc định: true.
  • idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không có thêm tác động nào đến môi trường của công cụ. Mặc định: false.
  • openWorldHint: Nếu đúng, công cụ này có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: một công cụ tìm kiếm trên web sẽ là thế giới mở, trong khi một công cụ bộ nhớ sẽ không phải là thế giới mở.

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ở: ❌