MCP Tools Reference: paydeveloper.googleapis.com

כלי: create_merchant

יוצר סוחר חדש עם החשבון המאומת. חובה לבקש מהמשתמש לספק את המידע הנדרש ליצירת מוכר. אחד משדות החובה הוא קוד הקטגוריה של המוֹכר (MCC). הרשימה של חשבונות הניהול ארוכה, ולכן אפשר להציג רק חלק מהאפשרויות הנפוצות, אבל חובה להודיע למשתמש שיש עוד אפשרויות ושהוא יכול לבקש את הרשימה המלאה (למשל, באמצעות הצגת הכיתוב 'X אפשרויות נוספות' או רמז דומה). בנוסף, צריך להודיע למשתמש שהוא יכול לספק ישירות את קוד ה-MCC בן 4 הספרות (למשל, 5499) אם הוא כבר יודע אותו, ולעודד אותו להשתמש בו. אל תתקשרו לכלי הזה לפני שתנסו לאסוף את המידע הנדרש ליצירת חשבון של מוֹכרים. אחרי שיוצרים את המוכר, חובה להציג למשתמש את כתובת ה-URL של התנאים וההגבלות של מסוף העסק ולתת לו הוראות לאשר אותם לפני שהוא מבצע פעולות כלשהן במוכר הזה.

בדוגמת הקוד הבאה מוצג שימוש בפקודה 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 MCP tool 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

חובה. קוד האזור של מיקום העסק של המוכר. הפורמט הוא קודי האזורים במאגר CLDR של Unicode, למשל US. אין תמיכה בהודו (IN).
mcc

enum (Mcc)

חובה. קוד קטגוריית הסוחר (MCC) של הסוחר.
corporateWebsiteUrl

string

חובה. האתר של התאגיד של המוֹכר.
customerSupportWebsiteUrl

string

חובה. אתר תמיכת הלקוחות של הסוחר.
customerSupportEmail

string

חובה. כתובת האימייל של המוקד לתמיכת לקוחות של המוכר.
customerSupportPhone

string

חובה. מספר הטלפון של תמיכת הלקוחות של המוֹכר.
state

enum (State)

פלט בלבד. המצב של המוֹכר.

Mcc

קוד קטגוריית המוֹכר (MCC) של מוֹכר.

טיפוסים בני מנייה (enum)
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 Card Shops, Gift, Novelty, and Souvenir 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)

הסטטוס של מוֹכר.

טיפוסים בני מנייה (enum)
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

מספר המזהה של המוכר שנוצר.
state

enum (State)

הסטטוס של המוכר שנוצר.
businessConsoleTosUrl

string

פלט בלבד. כתובת ה-URL של התנאים וההגבלות של המסוף העסקי. כדי לבצע פעולות בחשבון המוכר, המשתמש צריך לאשר את התנאים וההגבלות של מסוף העסק.

מדינה (State)

הסטטוס של מוֹכר.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED לא צוין סטטוס המוכר.
VERIFIED המוכר מאומת ומאושר.
IN_REVIEW עריכת פרופיל הסוחר נמצאת בבדיקה.
REJECTED העריכה של פרופיל המוֹכר נדחית.
INCOMPLETE_SIGNUP פרופיל המוכר לא הושלם.
SANCTIONS_HIT פרופיל המוכר מושפע מסנקציות.
READY_FOR_REVIEW פרופיל המוֹכר הושלם ומוכן לבדיקה.
DISABLED פרופיל המוכר מושבת או לא פעיל.

הערות על כלים

הערות על כלים נשלחות ללקוחות MCP כדי לתאר את הסיכון הבסיסי של כלי מסוים. רוב הלקוחות מתייחסים לרמזים האלה כאל רמזים לא מהימנים, אבל אפשר להשתמש בהם כדי להחליט מתי לשלוח למשתמש בקשת אישור.

בנוסף למחרוזת הכותרת, מוגדרים הרמזים הבוליאניים הבאים:

  • ‫readOnlyHint: אם הערך הוא true, הכלי לא משנה את הסביבה שלו. ברירת מחדל: false.
  • ‫destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא false, הכלי יכול לבצע רק פעולות של הוספה. ברירת מחדל: true.
  • ‫idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת מחדל: false.
  • ‫openWorldHint: אם הערך הוא True, הכלי יכול ליצור אינטראקציה עם 'עולם פתוח' של ישויות חיצוניות. אם הערך הוא false, הכלי יכול ליצור אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי לחיפוש באינטרנט יהיה עולם פתוח, אבל כלי לזיכרון לא יהיה עולם פתוח.

רמז הרסני: ❌ | רמז אידמפוטנטי: ❌ | רמז לקריאה בלבד: ❌ | רמז לעולם פתוח: ❌