MCP Tools Reference: paydeveloper.googleapis.com

الأداة: create_merchant

تنشئ هذه الطريقة تاجرًا جديدًا باستخدام الحساب الذي تمّت مصادقته. يجب أن تطلب من المستخدم تقديم المعلومات المطلوبة لإنشاء التاجر. لا تستخدِم هذه الأداة إلا بعد محاولة جمع المعلومات المطلوبة لإنشاء التاجر. بعد إنشاء التاجر، يجب أن تعرض على المستخدم عنوان 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 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

الحقل مطلوب. تمثّل هذه السمة رمز المنطقة للموقع الجغرافي الذي يقع فيه النشاط التجاري للتاجر. التنسيق هو رموز 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. يجب أن يوافق المستخدم على بنود خدمة Business Console قبل أن يتمكّن من تنفيذ أي عمليات على التاجر.

ولاية

حالة التاجر

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

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

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌