MCP Tools Reference: paydeveloper.googleapis.com

ابزار: create_merchant

یک تاجر جدید با حساب احراز هویت شده ایجاد می‌کند. شما باید از کاربر بخواهید اطلاعات مورد نیاز برای ایجاد تاجر را ارائه دهد. یکی از فیلدهای مورد نیاز، کد دسته‌بندی تاجر (MCC) است. از آنجایی که لیست MCCها طولانی است، می‌توانید زیرمجموعه‌ای از گزینه‌های رایج را ارائه دهید، اما باید به کاربر اطلاع دهید که گزینه‌های بیشتری در دسترس هستند و می‌توانند لیست کامل را درخواست کنند (مثلاً با نشان دادن "X گزینه بیشتر" یا راهنمایی مشابه). علاوه بر این، به کاربر اطلاع دهید که اگر از قبل کد MCC 4 رقمی (مثلاً 5499) را می‌داند، می‌تواند مستقیماً آن را ارائه دهد و او را به استفاده از آن تشویق کنید. تا زمانی که تلاش نکرده‌اید اطلاعات مورد نیاز برای ایجاد تاجر را جمع‌آوری کنید، از این ابزار استفاده نکنید. پس از ایجاد تاجر، باید URL شرایط خدمات کنسول تجاری را به کاربر ارائه دهید و به او دستور دهید قبل از انجام هرگونه عملیاتی روی این تاجر، آن را بپذیرد.

نمونه کد زیر نحوه استفاده از curl برای فراخوانی ابزار create_merchant MCP را نشان می‌دهد.

درخواست کرل 
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
}'

طرحواره ورودی

درخواست پیام برای CreateMerchant.

درخواست ایجاد فروشنده

نمایش 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

الزامی. کد منطقه محل کسب و کار فروشنده. قالب آن کدهای منطقه یونیکد CLDR است، مثلاً "US". هند ("IN") پشتیبانی نمی‌شود.

mcc

enum ( Mcc )

الزامی. کد دسته‌بندی فروشگاه (MCC) فروشگاه.

corporateWebsiteUrl

string

الزامی. وب‌سایت شرکتیِ فروشنده.

customerSupportWebsiteUrl

string

الزامی. وب‌سایت پشتیبانی مشتری فروشنده.

customerSupportEmail

string

الزامی. ایمیل پشتیبانی مشتری فروشنده.

customerSupportPhone

string

الزامی. شماره تلفن پشتیبانی مشتری فروشنده.

state

enum ( State )

فقط خروجی. وضعیت تاجر.

مک سی سی

کد دسته‌بندی تاجر (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.

ایجاد پاسخ فروشنده

نمایش JSON 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
فیلدها
merchantId

string

شناسه‌ی فروشنده‌ی ایجاد شده.

state

enum ( State )

وضعیت تاجر ایجاد شده.

businessConsoleTosUrl

string

فقط خروجی. نشانی اینترنتی شرایط خدمات کنسول تجاری. کاربر باید قبل از انجام هرگونه عملیاتی روی فروشنده، شرایط خدمات کنسول تجاری را بپذیرد.

ایالت

وضعیت یک تاجر.

انوم‌ها
STATE_UNSPECIFIED ایالت تاجر مشخص نشده است.
VERIFIED فروشنده بررسی و تایید شده است.
IN_REVIEW ویرایش پروفایل فروشنده در دست بررسی است.
REJECTED ویرایش پروفایل فروشنده رد می‌شود.
INCOMPLETE_SIGNUP مشخصات فروشنده ناقص است.
SANCTIONS_HIT وضعیت تاجران با تحریم‌ها مواجه می‌شود.
READY_FOR_REVIEW مشخصات فروشنده تکمیل و آماده بررسی است.
DISABLED نمایه فروشنده غیرفعال/غیرفعال است.

حاشیه‌نویسی ابزار

حاشیه‌نویسی‌های ابزار برای توصیف ریسک اولیه‌ی یک ابزار مشخص به کلاینت‌های MCP ارسال می‌شوند. اکثر کلاینت‌ها این نکات را غیرقابل اعتماد می‌دانند، اما می‌توان از آنها برای تصمیم‌گیری در مورد زمان ارسال پیام تأیید به کاربر استفاده کرد.

همراه با رشته عنوان، نکات بولی زیر به صورت زیر تعریف می‌شوند:

  • readOnlyHint : اگر درست باشد، ابزار محیط خود را تغییر نمی‌دهد. پیش‌فرض: نادرست.
  • destructiveHint : اگر درست باشد، ابزار می‌تواند اقدامات مخرب انجام دهد. اگر نادرست باشد، ابزار فقط می‌تواند اقدامات افزایشی انجام دهد. پیش‌فرض: درست.
  • idempotentHint : اگر مقدار آن درست باشد، فراخوانی مکرر ابزار با آرگومان‌های یکسان، هیچ تأثیر اضافی بر محیط آن نخواهد داشت. پیش‌فرض: false.
  • openWorldHint : اگر درست باشد، ابزار می‌تواند با «دنیای باز» از موجودیت‌های خارجی تعامل داشته باشد. اگر نادرست باشد، ابزار فقط می‌تواند با موجودیت‌های داخلی تعامل داشته باشد. برای مثال، یک ابزار جستجوی وب جهان‌باز خواهد بود، در حالی که یک ابزار حافظه جهان‌باز نخواهد بود.

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ❌ | راهنمایی فقط خواندنی: ❌ | راهنمایی جهان باز: ❌