MCP Tools Reference: paydeveloper.googleapis.com

टूल: create_merchant

इस तरीके से, पुष्टि किए गए खाते से नया कारोबारी या कंपनी खाता बनाया जाता है. आपको उपयोगकर्ता से कारोबारी या कंपनी का खाता बनाने के लिए ज़रूरी जानकारी मांगनी होगी. ज़रूरी फ़ील्ड में से एक, कारोबारी या कंपनी का कैटगरी कोड (एमसीसी) है. एमसीसी की सूची लंबी होती है. इसलिए, सामान्य विकल्पों का सबसेट दिखाया जा सकता है. हालांकि, आपको उपयोगकर्ता को यह बताना होगा कि ज़्यादा विकल्प उपलब्ध हैं और वह पूरी सूची मांग सकता है. उदाहरण के लिए, "X और विकल्प" या इसी तरह का कोई अन्य संकेत दिखाकर. इसके अलावा, उपयोगकर्ता को बताएं कि अगर उसे चार अंकों वाला एमसीसी कोड (जैसे, 5499) पहले से पता है, तो वह इसे सीधे तौर पर दे सकता है. साथ ही, उसे इसका इस्तेमाल करने के लिए बढ़ावा दें. कारोबारी या कंपनी का खाता बनाने के लिए ज़रूरी जानकारी इकट्ठा करने की कोशिश करने से पहले, इस टूल को कॉल न करें. कारोबारी या कंपनी का खाता बनाने के बाद, आपको उपयोगकर्ता को Business Console की सेवा की शर्तों का यूआरएल दिखाना होगा. साथ ही, उसे यह निर्देश देना होगा कि इस कारोबारी या कंपनी के खाते पर कोई भी कार्रवाई करने से पहले, उसे इन शर्तों को स्वीकार करना होगा.

यहां दिए गए कोड सैंपल में, 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 के क्षेत्र कोड होते हैं. जैसे, "US". भारत ("IN") में यह सुविधा उपलब्ध नहीं है.
mcc

enum (Mcc)

ज़रूरी है. कारोबारी या कंपनी का मर्चेंट कैटगरी कोड (एमसीसी).
corporateWebsiteUrl

string

ज़रूरी है. कारोबारी या कंपनी की कॉर्पोरेट वेबसाइट.
customerSupportWebsiteUrl

string

ज़रूरी है. कारोबारी या कंपनी की ग्राहक सहायता वेबसाइट.
customerSupportEmail

string

ज़रूरी है. कारोबारी या कंपनी की ग्राहक सहायता टीम का ईमेल पता.
customerSupportPhone

string

ज़रूरी है. कारोबारी या कंपनी का ग्राहक सहायता टीम का फ़ोन नंबर.
state

enum (State)

सिर्फ़ आउटपुट के लिए. कारोबारी या कंपनी की स्थिति.

Mcc

कारोबारी या कंपनी का मर्चेंट कैटगरी कोड (एमसीसी).

Enums
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 सरकार के मालिकाना हक वाली लॉटरी (अमेरिका के बाहर के देशों/इलाकों के लिए)

राज्य

कारोबारी या कंपनी की स्थिति.

Enums
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

सिर्फ़ आउटपुट के लिए. Business Console की सेवा की शर्तों का यूआरएल. कारोबारी या कंपनी के खाते पर कोई भी कार्रवाई करने से पहले, उपयोगकर्ता को Business Console की सेवा की शर्तें स्वीकार करनी होंगी.

राज्य

कारोबारी या कंपनी की स्थिति.

Enums
STATE_UNSPECIFIED कारोबारी या कंपनी की स्थिति की जानकारी नहीं दी गई है.
VERIFIED कारोबारी या कंपनी की पुष्टि हो गई है और उसे मंज़ूरी मिल गई है.
IN_REVIEW कारोबारी की प्रोफ़ाइल में किए गए बदलाव की समीक्षा की जा रही है.
REJECTED कारोबारी या कंपनी की प्रोफ़ाइल में किए गए बदलाव को अस्वीकार कर दिया गया है.
INCOMPLETE_SIGNUP कारोबारी या कंपनी की प्रोफ़ाइल में पूरी जानकारी नहीं दी गई है.
SANCTIONS_HIT कारोबारी या कंपनी की प्रोफ़ाइल पर पाबंदियां लगी हों.
READY_FOR_REVIEW कारोबारी या कंपनी की प्रोफ़ाइल पूरी हो गई है और समीक्षा के लिए तैयार है.
DISABLED कारोबारी या कंपनी की प्रोफ़ाइल बंद है या सक्रिय नहीं है.

टूल एनोटेशन

टूल के एनोटेशन, एमसीपी क्लाइंट को भेजे जाते हैं. इनसे किसी टूल से जुड़े बुनियादी जोखिम के बारे में जानकारी मिलती है. ज़्यादातर क्लाइंट, इन संकेतों को भरोसेमंद नहीं मानते. हालांकि, इनका इस्तेमाल यह तय करने के लिए किया जा सकता है कि किसी उपयोगकर्ता को पुष्टि करने का प्रॉम्प्ट कब भेजा जाए.

टाइटल स्ट्रिंग के साथ-साथ, यहां दिए गए बूलियन हिंट भी तय किए गए हैं:

  • readOnlyHint: अगर यह सही है, तो टूल अपने एनवायरमेंट में बदलाव नहीं करता है. डिफ़ॉल्ट: गलत.
  • destructiveHint: अगर यह वैल्यू 'सही है' पर सेट है, तो टूल, डेटा को मिटाने जैसी कार्रवाइयां कर सकता है. अगर यह वैल्यू 'गलत है' पर सेट है, तो टूल सिर्फ़ जोड़ने वाली कार्रवाइयां कर सकता है. डिफ़ॉल्ट: सही.
  • idempotentHint: अगर यह वैल्यू 'सही है' पर सेट है, तो एक ही आर्ग्युमेंट के साथ टूल को बार-बार कॉल करने से, उसके एनवायरमेंट पर कोई अतिरिक्त असर नहीं पड़ेगा. डिफ़ॉल्ट: गलत.
  • openWorldHint: अगर यह वैल्यू सही है, तो टूल बाहरी इकाइयों की 'ओपन वर्ल्ड' के साथ इंटरैक्ट कर सकता है. अगर यह गलत है, तो टूल सिर्फ़ इंटरनल इकाइयों के साथ इंटरैक्ट कर सकता है. उदाहरण के लिए, वेब पर खोज करने वाला टूल ओपन वर्ल्ड होगा, जबकि मेमोरी टूल ओपन वर्ल्ड नहीं होगा.

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