MCP Tools Reference: paydeveloper.googleapis.com

כלי: create_merchant

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

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ create_merchant.

בקשת 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

פלט בלבד. המזהה הייחודי של המוכר.
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 חנויות כרטיסים, חנויות מתנות, חנויות של מתנות מיוחדות וחנויות מזכרות
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 פרופיל המוכר מושבת או לא פעיל.

הערות על כלים

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