MCP Tools Reference: paydeveloper.googleapis.com

الأداة: create_merchant

تنشئ هذه الطريقة تاجرًا جديدًا باستخدام الحساب الذي تمّت مصادقته. يجب أن تطلب من المستخدم تقديم المعلومات المطلوبة لإنشاء التاجر. أحد الحقول المطلوبة هو رمز فئة التاجر (MCC). بما أنّ قائمة رموز MCC طويلة، يمكنك عرض مجموعة فرعية من الخيارات الشائعة، ولكن يجب إعلام المستخدم بأنّه تتوفّر خيارات إضافية ويمكنه طلب القائمة الكاملة (على سبيل المثال، من خلال عرض "X خيارات إضافية" أو تلميح مشابه). بالإضافة إلى ذلك، أبلِغ المستخدم بأنّه يمكنه تقديم رمز "مركز عملائي" المكوّن من 4 أرقام (مثل 5499) مباشرةً إذا كان يعرفه، وشجِّعه على استخدامه. لا تستخدِم هذه الأداة إلا بعد محاولة جمع المعلومات المطلوبة لإنشاء التاجر. بعد إنشاء التاجر، يجب أن تعرض على المستخدم عنوان URL الخاص ببنود خدمة Business Console وتطلب منه الموافقة عليها قبل أن يتمكّن من تنفيذ أي عمليات على هذا التاجر.

يوضّح نموذج الرمز التالي كيفية استخدام 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

الحقل مطلوب. تمثّل هذه السمة رمز المنطقة للموقع الجغرافي الذي يقع فيه النشاط التجاري للتاجر. التنسيق هو رموز Unicode CLDR للمناطق، مثل "US". لا تتوفّر هذه الخدمة في الهند ("IN").
mcc

enum (Mcc)

الحقل مطلوب. رمز فئة التجار (MCC) الخاص بالتاجر
corporateWebsiteUrl

string

الحقل مطلوب. الموقع الإلكتروني للشركة التابعة للتاجر
customerSupportWebsiteUrl

string

الحقل مطلوب. الموقع الإلكتروني المخصّص لدعم العملاء الخاص بالتاجر
customerSupportEmail

string

الحقل مطلوب. البريد الإلكتروني الخاص بفريق دعم العملاء لدى التاجر
customerSupportPhone

string

الحقل مطلوب. رقم هاتف فريق دعم العملاء الخاص بالتاجر
state

enum (State)

النتائج فقط. حالة التاجر

Mcc

رمز فئة التجار (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

CreateMerchantResponse

تمثيل JSON 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
الحقول
merchantId

string

معرّف التاجر الذي تم إنشاؤه
state

enum (State)

تمثّل هذه السمة حالة التاجر الذي تم إنشاؤه.
businessConsoleTosUrl

string

النتائج فقط. عنوان URL الخاص ببنود خدمة Business Console على المستخدم قبول بنود خدمة "وحدة تحكّم النشاط التجاري" قبل أن يتمكّن من تنفيذ أي عمليات على التاجر.

ولاية

حالة التاجر

عمليات التعداد
STATE_UNSPECIFIED لم يتم تحديد حالة التاجر.
VERIFIED تم التحقّق من التاجر والموافقة عليه.
IN_REVIEW تعديل ملف التاجر قيد المراجعة.
REJECTED تم رفض تعديل ملف التاجر.
INCOMPLETE_SIGNUP ملف التاجر غير مكتمل.
SANCTIONS_HIT ملف التاجر يخضع لعقوبات.
READY_FOR_REVIEW ملف التاجر مكتمل وجاهز للمراجعة.
DISABLED ملف التاجر غير مفعَّل أو تم إيقافه.

التعليقات التوضيحية للأدوات

يتم إرسال تعليقات توضيحية للأدوات إلى عملاء MCP لوصف المخاطر الأساسية لأداة معيّنة. تتعامل معظم البرامج مع هذه التلميحات على أنّها غير موثوق بها، ولكن يمكن استخدامها لتحديد الوقت الذي قد يتم فيه إرسال طلب تأكيد إلى المستخدم.

بالإضافة إلى سلسلة العنوان، يتم تحديد تلميحات القيم المنطقية التالية على النحو التالي:

  • ‫readOnlyHint: إذا كانت القيمة صحيحة، لن تعدّل الأداة بيئتها. القيمة التلقائية: false.
  • ‫destructiveHint: إذا كانت القيمة صحيحة، يمكن للأداة تنفيذ إجراءات مدمّرة. إذا كانت القيمة "خطأ"، يمكن للأداة تنفيذ إجراءات إضافية فقط. القيمة التلقائية: true
  • idempotentHint: إذا كانت القيمة صحيحة، لن يكون لاستدعاء الأداة بشكل متكرر باستخدام الوسيطات نفسها أي تأثير إضافي على بيئتها. القيمة التلقائية: false.
  • openWorldHint: إذا كانت القيمة صحيحة، يمكن للأداة التفاعل مع "عالم مفتوح" من الكيانات الخارجية. إذا كانت القيمة خطأ، يمكن للأداة التفاعل مع الكيانات الداخلية فقط. على سبيل المثال، ستكون أداة البحث على الويب عالمًا مفتوحًا، بينما لن تكون أداة الذاكرة عالمًا مفتوحًا.

تلميح بشأن التدمير: ❌ | تلميح بشأن التكرار: ❌ | تلميح بشأن القراءة فقط: ❌ | تلميح بشأن العالم المفتوح: ❌