MCP Tools Reference: paydeveloper.googleapis.com

टूल: list_google_pay_integrations

यह किसी Merchant ID से जुड़े सभी Google Pay इंटिग्रेशन के लिए, मौजूदा स्थिति और कॉन्फ़िगरेशन की जानकारी दिखाता है. यह एकीकरण की स्थिति और दस्तावेज़ समीक्षाओं पर तत्काल प्रतिक्रिया प्रदान करता है. इसके अलावा, आपको उपयोगकर्ता को यह बताना होगा कि Google Pay और Wallet Console (https://pay.google.com/business/console/) में इंटिग्रेशन बनाया/अपडेट किया जा सकता है.

यहां दिए गए कोड सैंपल में, list_google_pay_integrations 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": "list_google_pay_integrations",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

किसी कारोबारी या कंपनी के लिए, Google Pay इंटिग्रेशन की लिस्टिंग के लिए अनुरोध करने वाला मैसेज.

ListGooglePayIntegrationsRequest

JSON के काेड में दिखाना 
{
  "merchantId": string
}
फ़ील्ड
merchantId

string

ज़रूरी है. वह मर्चेंट आईडी जिसके लिए इंटिग्रेशन की सूची बनानी है.

आउटपुट स्कीमा

Google Pay इंटिग्रेशन की सूची बनाने के लिए जवाब का मैसेज.

ListGooglePayIntegrationsResponse

JSON के काेड में दिखाना 
{
  "googlePayIntegrations": [
    {
      object (GooglePayIntegration)
    }
  ]
}
फ़ील्ड
googlePayIntegrations[]

object (GooglePayIntegration)

कारोबारी या कंपनी के Google Pay इंटिग्रेशन.

GooglePayIntegration

JSON के काेड में दिखाना 
{
  "integrationState": enum (IntegrationState),
  "createTime": string,
  "updateTime": string,
  "integrationType": enum (IntegrationType),
  "integrationDocuments": [
    {
      object (IntegrationDocument)
    }
  ],

  // Union field item can be only one of the following:
  "webDomain": string,
  "androidAppPackage": string
  // End of list of possible types for union field item.
}
फ़ील्ड
integrationState

enum (IntegrationState)

सिर्फ़ आउटपुट के लिए. व्यापारी के Google Pay एकीकरण की स्थिति.
createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इंटीग्रेशन रिसॉर्स कब बनाया गया था.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इंटिग्रेशन रिसॉर्स को पिछली बार कब अपडेट किया गया था.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

ज़रूरी है. Google Pay इंटिग्रेशन का टाइप.
integrationDocuments[]

object (IntegrationDocument)

ज़रूरी है. सिर्फ़ इनपुट के लिए. गूगल पे इंटीग्रेशन के इंटीग्रेशन दस्तावेज़.
यूनियन फ़ील्ड item. इंटिग्रेशन आइटम. इनमें से किसी एक को सेट करना ज़रूरी है. item इनमें से सिर्फ़ एक हो सकता है:
webDomain

string

कारोबारी या कंपनी का वेब डोमेन.
androidAppPackage

string

कारोबारी या कंपनी के Android ऐप्लिकेशन के पैकेज का नाम.

टाइमस्टैम्प

JSON के काेड में दिखाना 
{
  "seconds": string,
  "nanos": integer
}
फ़ील्ड
seconds

string (int64 format)

यह Unix epoch 1970-01-01T00:00:00Z के बाद से यूटीसी समय के सेकंड दिखाता है. यह -62135596800 और 253402300799 के बीच होना चाहिए. इसमें ये दोनों वैल्यू भी शामिल हैं. यह 0001-01-01T00:00:00Z से 9999-12-31T23:59:59Z के बीच की वैल्यू के बराबर होता है.
nanos

integer

नैनोसेकंड रिज़ॉल्यूशन पर, एक सेकंड के नॉन-नेगेटिव फ़्रैक्शन. यह फ़ील्ड, अवधि का नैनोसेकंड वाला हिस्सा है. यह सेकंड का विकल्प नहीं है. भिन्नात्मक वैल्यू वाली नेगेटिव सेकंड वैल्यू में, अब भी नॉन-नेगेटिव नैनो वैल्यू होनी चाहिए. इससे समय की गिनती आगे की ओर होती है. यह 0 और 99,99,99,999 के बीच होना चाहिए.

IntegrationDocument

JSON के काेड में दिखाना 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
फ़ील्ड
name

string

ज़रूरी है. दस्तावेज़ का नाम.
data

string (bytes format)

ज़रूरी है. दस्तावेज़ का डेटा.

base64 कोड में बदली गई स्ट्रिंग.
documentType

enum (DocumentType)

ज़रूरी है. दस्तावेज़ किस तरह का है.
mimeType

enum (MimeType)

ज़रूरी है. दस्तावेज़ का MIME टाइप.

IntegrationState

कारोबारी या कंपनी के वेब डोमेन या Android ऐप्लिकेशन के लिए, Google Pay इंटिग्रेशन की स्थिति.

Enums
INTEGRATION_STATE_UNSPECIFIED इंटिग्रेशन के स्टेटस की जानकारी नहीं दी गई है.
NOT_STARTED यह स्थिति तब होती है, जब Android ऐप्लिकेशन, डेवलपर से जुड़ा हो (Play Store पर) और डेवलपर ने इसके लिए इंटिग्रेशन की कोई प्रोसेस शुरू न की हो.
INCOMPLETE डेवलपर ने अब तक इंटिग्रेशन की समीक्षा के लिए सबमिट नहीं किया है.साथ ही, यह पूरा भी नहीं है. उदाहरण के लिए, ज़रूरी दस्तावेज़ मौजूद नहीं हैं.
READY_FOR_REVIEW डेवलपर ने अब तक इंटिग्रेशन को समीक्षा के लिए सबमिट नहीं किया है, लेकिन यह समीक्षा के लिए तैयार है. उदाहरण के लिए, इससे जुड़े दस्तावेज़ अपलोड कर दिए गए हैं.
UNDER_REVIEW एडमिन, इंटिग्रेशन चालू करने के अनुरोध की समीक्षा कर रहा है.
NEED_INFO समीक्षा के दौरान, gTech एडमिन को इंटिग्रेशन के बारे में ज़्यादा जानकारी देनी होगी.
ACTIVE फ़िलहाल, इंटिग्रेशन चालू है.
DELETED कारोबारी या कंपनी ने इंटिग्रेशन मिटा दिया हो.
REJECTED इंटिग्रेशन को अस्वीकार कर दिया गया है.

IntegrationType

Google Pay इंटिग्रेशन का इंटिग्रेशन टाइप.

Enums
INTEGRATION_TYPE_UNSPECIFIED इंटिग्रेशन का टाइप नहीं बताया गया है.
DIRECT_INTEGRATION इंटिग्रेशन का टाइप, डायरेक्ट इंटिग्रेशन है.
PAYMENT_SERVICE_PROVIDER इंटिग्रेशन का टाइप, पेमेंट की सेवा देने वाली कंपनी है.

DocumentType

दस्तावेज़ का टाइप.

Enums
DOCUMENT_TYPE_UNSPECIFIED दस्तावेज़ का टाइप नहीं बताया गया है.
ITEM_SELECTION_SCREENSHOT जब कोई उपयोगकर्ता किसी आइटम या सेवा को ब्राउज़ करता है.
PRE_PURCHASE_SCREENSHOT जब उपयोगकर्ता खरीदारी करने के लिए पूरी तरह तैयार हो.
PAYMENT_METHOD_SCREENSHOT जब कोई उपयोगकर्ता, पेमेंट के तरीके के तौर पर Google Pay को चुनता है.
PAYMENT_INFO_SCREENSHOT जब किसी उपयोगकर्ता को Google Pay में सहेजी गई भुगतान जानकारी दिखाई जाती है. अहम जानकारी: Android में इस स्क्रीन का स्क्रीनशॉट नहीं लिया जा सकता है, इसलिए किसी दूसरे डिवाइस से फ़ोटो खींचें.
POST_PURCHASE_SCREENSHOT जब कोई उपयोगकर्ता खरीदारी कर लेता है.
PCI_ATTESTATION_DOCUMENT PCI की पुष्टि करने वाला दस्तावेज़, PDF फ़ॉर्मैट में होना चाहिए.

MimeType

किसी दस्तावेज़ का MIME टाइप.

Enums
MIME_TYPE_UNSPECIFIED माइम टाइप की जानकारी नहीं दी गई है.
JPEG MIME प्रकार JPEG है.
PNG माइम टाइप PNG है.
WEBP MIME टाइप WEBP है.
PDF MIME टाइप PDF है.

टूल एनोटेशन

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

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

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

डेटा में बदलाव करने से जुड़ी जानकारी: ❌ | एक ही अनुरोध को कई बार भेजने पर भी नतीजे में कोई बदलाव न होने से जुड़ी जानकारी: ✅ | सिर्फ़ पढ़ने से जुड़ी जानकारी: ✅ | ओपन वर्ल्ड से जुड़ी जानकारी: ❌