MCP Tools Reference: paydeveloper.googleapis.com

ابزار: create_google_pay_integration

یک ادغام Google Pay برای یک فروشنده خاص ایجاد می‌کند. این عملیات مستلزم آن است که کاربر شرایط خدمات کنسول تجاری و شرایط خدمات API Google Pay را پذیرفته باشد. نیازی به بررسی پیشگیرانه این موارد نیست. اگر آنها پذیرفته نشده باشند، فراخوانی ابزار با شکست مواجه می‌شود و پیام خطا حاوی URL های خاص شرایط خدمات خواهد بود که باید پذیرفته شوند. در این صورت، URL ها را برای پذیرش به کاربر ارائه دهید و به آنها دستور دهید که پس از پذیرش دوباره امتحان کنند. قبل از فراخوانی ابزار، برای تعامل با کاربر، این ترتیب را دنبال کنید: ۱. ابتدا، از کاربر مورد ادغام را بپرسید (در حال حاضر فقط ادغام وب پشتیبانی می‌شود). - آدرس اینترنتی وب‌سایت را بپرسید. # - اگر مورد ادغام ادغام برنامه است، نام بسته برنامه اندروید را بپرسید. ۲. سپس، نوع ادغام را از کاربر بپرسید: - به کاربر بگویید اگر از یکی از ارائه دهندگان خدمات پرداخت پشتیبانی شده ما (PSP ها: https://developers.google.com/pay/api#participating-processors ) استفاده می‌کند، Gateway را انتخاب کند، در غیر این صورت Direct را انتخاب کنید. ۳. برای همه انواع ادغام (مستقیم یا دروازه): - به کاربر بگویید که اسکرین‌شات‌هایی (حداکثر ۱ مگابایت) از جریان خرید خود که با API گوگل پی یکپارچه شده است را آپلود کند. جریان خرید آنها باید قبل از دسترسی کامل به محصول، بررسی و تأیید شود. مثال‌ها: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together . - باید از کاربر بخواهید ۵ اسکرین‌شات پشتیبان ارائه دهد. برای اطمینان از نگاشت صحیح، آنها را یکی یکی درخواست کنید. هنگام درخواست، فقط از توضیحات کاربرپسند enum استفاده کنید. ۴. اگر نوع ادغام مستقیم است: - همچنین باید از کاربر بخواهید سند گواهی PCI را با فرمت PDF ارائه دهد. هنگام درخواست، فقط از توضیحات کاربرپسند enum استفاده کنید. ۵. برای هر فایل ارائه شده، از کاربر بخواهید که مسیر یا نام سند را در صورت وجود در دایرکتوری فعلی ارائه دهد. آن را به DocumentType صحیح نگاشت کنید و فیلد نام را در درخواست روی یک نام توصیفی (مثلاً item_selection.png یا pci_attestation.pdf) تنظیم کنید. تا زمانی که برای جمع‌آوری اسناد مورد نیاز برای نوع ادغام انتخاب شده تلاش نکرده‌اید، این ابزار را فراخوانی نکنید.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار MCP create_google_pay_integration را نشان می‌دهد.

درخواست کرل 
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_google_pay_integration",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

طرحواره ورودی

درخواست پیام برای CreateGooglePayIntegration.

درخواست ادغام با گوگل پی را ایجاد کنید

نمایش JSON 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
فیلدها
merchantId

string

الزامی. شناسه فروشنده که قرار است ادغام گوگل پی به آن اضافه شود.

googlePayIntegration

object ( 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 )

فقط خروجی. وضعیت ادغام فروشگاه با گوگل پی.

createTime

string ( Timestamp format)

فقط خروجی. زمانی که منبع یکپارچه‌سازی ایجاد شد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

updateTime

string ( Timestamp format)

فقط خروجی. آخرین باری که منبع ادغام به‌روزرسانی شده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

integrationType

enum ( IntegrationType )

الزامی. نوع ادغام با گوگل پی.

integrationDocuments[]

object ( IntegrationDocument )

الزامی. فقط ورودی. اسناد ادغام با Google Pay.

item Union. آیتم ادغام. یکی از این موارد باید تنظیم شود. item فقط می‌تواند یکی از موارد زیر باشد:
webDomain

string

دامنه وب تاجر.

androidAppPackage

string

نام بسته برنامه اندروید فروشنده.

مهر زمانی

نمایش JSON 
{
  "seconds": string,
  "nanos": integer
}
فیلدها
seconds

string ( int64 format)

ثانیه‌های زمان UTC را از زمان یونیکس ۱۹۷۰-۰۱-۰۱T۰۰:۰۰:۰۰Z نشان می‌دهد. باید بین -۶۲۱۳۵۵۹۶۸۰۰ و ۲۵۳۴۰۲۳۰۰۷۹۹ باشد (که معادل ۰۰۰۱-۰۱-۰۱T۰۰:۰۰:۰۰Z تا ۹۹۹۹-۱۲-۳۱T۲۳:۵۹:۵۹Z است).

nanos

integer

کسرهای غیرمنفی ثانیه با وضوح نانوثانیه. این فیلد بخش نانوثانیه از مدت زمان است، نه جایگزینی برای ثانیه. مقادیر منفی ثانیه با کسرها باید همچنان دارای مقادیر نانوثانیه غیرمنفی باشند که در زمان به جلو شمارش می‌شوند. باید بین ۰ تا ۹۹۹۹۹۹۹۹۹۹ باشد.

سند ادغام

نمایش 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 سند.

حالت ادغام

وضعیت ادغام Google Pay در یک دامنه وب فروشگاه یا برنامه اندروید.

انوم‌ها
INTEGRATION_STATE_UNSPECIFIED وضعیت ادغام مشخص نشده است.
NOT_STARTED این وضعیت برای زمانی است که برنامه اندروید با توسعه‌دهنده (در فروشگاه Play) مرتبط است و توسعه‌دهنده هیچ فرآیند ادغامی را برای آن آغاز نکرده است.
INCOMPLETE توسعه‌دهنده هنوز ادغام را برای بررسی ارسال نکرده است و همچنین کامل نیست (مثلاً اسناد پشتیبان موجود نیست).
READY_FOR_REVIEW توسعه‌دهنده هنوز ادغام را برای بررسی ارسال نکرده است، اما آماده بررسی است (مثلاً اسناد پشتیبان آپلود شده‌اند).
UNDER_REVIEW درخواست فعال‌سازی ادغام در انتظار بررسی توسط مدیر است.
NEED_INFO این ادغام نیاز به اطلاعات بیشتری توسط مدیر gTech در طول بررسی دارد.
ACTIVE این ادغام در حال حاضر فعال است.
DELETED ادغام توسط فروشنده حذف می‌شود.
REJECTED ادغام رد می‌شود.

نوع ادغام

نوع ادغام ادغام Google Pay.

انوم‌ها
INTEGRATION_TYPE_UNSPECIFIED نوع ادغام مشخص نشده است.
DIRECT_INTEGRATION نوع ادغام، ادغام مستقیم است.
PAYMENT_SERVICE_PROVIDER نوع ادغام، ارائه دهنده خدمات پرداخت است.

نوع سند

نوع سند.

انوم‌ها
DOCUMENT_TYPE_UNSPECIFIED نوع سند مشخص نیست.
ITEM_SELECTION_SCREENSHOT وقتی کاربری در حال مرور یک کالا یا سرویس است.
PRE_PURCHASE_SCREENSHOT وقتی کاربر در نهایت آماده خرید است.
PAYMENT_METHOD_SCREENSHOT وقتی کاربر Google Pay را به عنوان روش پرداخت خود انتخاب می‌کند.
PAYMENT_INFO_SCREENSHOT وقتی اطلاعات پرداختی که کاربر در Google Pay ذخیره کرده است به او نشان داده می‌شود. نکته: اندروید به شما اجازه نمی‌دهد از این صفحه عکس بگیرید، بنابراین با استفاده از دستگاه دیگری از صفحه عکس بگیرید.
POST_PURCHASE_SCREENSHOT وقتی کاربر خرید موفقی انجام داده باشد.
PCI_ATTESTATION_DOCUMENT سند تأیید PCI در قالب PDF.

نوع مایم

نوع mime یک سند.

انوم‌ها
MIME_TYPE_UNSPECIFIED نوع mime مشخص نشده است.
JPEG نوع MIME آن JPEG است.
PNG نوع mime آن PNG است.
WEBP نوع مایم WEBP است.
PDF نوع mime آن PDF است.

طرحواره خروجی

پیام پاسخ برای CreateGooglePayIntegration.

ایجاد پاسخ یکپارچه‌سازی گوگل‌پی

نمایش JSON 
{
  "integrationState": enum (IntegrationState)
}
فیلدها
integrationState

enum ( IntegrationState )

وضعیت ادغام با گوگل پی.

حالت ادغام

وضعیت ادغام Google Pay در یک دامنه وب فروشگاه یا برنامه اندروید.

انوم‌ها
INTEGRATION_STATE_UNSPECIFIED وضعیت ادغام مشخص نشده است.
NOT_STARTED این وضعیت برای زمانی است که برنامه اندروید با توسعه‌دهنده (در فروشگاه Play) مرتبط است و توسعه‌دهنده هیچ فرآیند ادغامی را برای آن آغاز نکرده است.
INCOMPLETE توسعه‌دهنده هنوز ادغام را برای بررسی ارسال نکرده است و همچنین کامل نیست (مثلاً اسناد پشتیبان موجود نیست).
READY_FOR_REVIEW توسعه‌دهنده هنوز ادغام را برای بررسی ارسال نکرده است، اما آماده بررسی است (مثلاً اسناد پشتیبان آپلود شده‌اند).
UNDER_REVIEW درخواست فعال‌سازی ادغام در انتظار بررسی توسط مدیر است.
NEED_INFO این ادغام نیاز به اطلاعات بیشتری توسط مدیر gTech در طول بررسی دارد.
ACTIVE این ادغام در حال حاضر فعال است.
DELETED ادغام توسط فروشنده حذف می‌شود.
REJECTED ادغام رد می‌شود.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ❌ | راهنمایی فقط خواندنی: ❌ | راهنمایی جهان باز: ❌