MCP Tools Reference: paydeveloper.googleapis.com

כלי: create_google_pay_integration

יוצר שילוב של Google Pay עבור מוכר ספציפי. כדי לבצע את הפעולה הזו, המשתמש צריך לאשר את התנאים וההגבלות של מסוף העסק ואת התנאים וההגבלות של Google Pay API. אין צורך לבדוק מראש אם יש עדכונים כאלה. אם הם לא אושרו, הקריאה לכלי תיכשל והודעת השגיאה תכיל את כתובות ה-URL הספציפיות של התנאים וההגבלות שצריך לאשר. במקרה כזה, צריך להציג למשתמש את כתובות ה-URL כדי שיאשר אותן, ולהנחות אותו לנסות שוב אחרי האישור. כדי ליצור אינטראקציה עם המשתמש לפני שמפעילים את הכלי, פועלים לפי הרצף הבא: 1. קודם כל, מבקשים מהמשתמש את פריט השילוב (בשלב הזה יש תמיכה רק בשילוב לאתרים). – מבקשים את כתובת האתר. ‫# – אם פריט השילוב הוא שילוב אפליקציה, צריך לבקש את שם חבילת ה-APK של האפליקציה ל-Android. 2. לאחר מכן, שואלים את המשתמש מהו סוג השילוב: - אם המשתמש משתמש באחד מספקי שירותי התשלום (PSP) הנתמכים שלנו (https://developers.google.com/pay/api#participating-processors), צריך לבחור באפשרות Gateway. אחרת, צריך לבחור באפשרות Direct. 3. לכל סוגי השילוב (ישיר או Gateway): - מבקשים מהמשתמש להעלות צילומי מסך (עד 1MB) של תהליך הקנייה שמשולב עם Google Pay API. כדי לקבל גישה מלאה לסביבת הייצור, אנחנו צריכים לבדוק ולאשר את תהליך הקנייה. דוגמאות: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. – עליך לבקש מהמשתמש לספק 5 צילומי מסך תומכים. מבקשים אותם אחד אחד כדי לוודא שהמיפוי נכון. כששואלים, צריך להשתמש רק בתיאורי ה-enum הידידותיים למשתמש. 4. אם סוג השילוב הוא ישיר: - אתם חייבים גם לבקש מהמשתמש לספק את מסמך האישור של PCI בפורמט PDF. כששואלים שאלה, צריך להשתמש רק בתיאור הידידותי למשתמש של ה-enum. 5. לכל קובץ שסופק, תבקש מהמשתמש לספק את נתיב המסמך או את השם שלו אם הוא נמצא בספרייה הנוכחית. ממפים אותו ל-DocumentType הנכון ומגדירים את שדה השם לשם תיאורי (לדוגמה, item_selection.png או pci_attestation.pdf) בבקשה. אל תתקשרו עם הכלי הזה לפני שתנסו לאסוף את המסמכים הנדרשים לסוג השילוב שבחרתם.

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ create_google_pay_integration.

בקשת 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_google_pay_integration",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

הודעת בקשה ל-CreateGooglePayIntegration.

CreateGooglePayIntegrationRequest

ייצוג ב-JSON 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
שדות
merchantId

string

חובה. מספר חשבון Merchant של המוכר שאליו רוצים להוסיף את השילוב של Google Pay.
googlePayIntegration

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)

פלט בלבד. מתי נוצר משאב השילוב.

הפלט שנוצר תמיד יהיה בפורמט RFC 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)

פלט בלבד. המועד שבו משאב השילוב עודכן לאחרונה.

הפלט שנוצר תמיד יהיה בפורמט RFC 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)

חובה. קלט בלבד. מסמכי השילוב של Google Pay.
שדה איחוד item. פריט השילוב. חובה להגדיר אחד מהם. הערך item יכול להיות רק אחד מהבאים:
webDomain

string

דומיין האינטרנט של המוֹכר.
androidAppPackage

string

שם חבילת ה-APK של המוכר באפליקציית Android.

חותמת זמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג את השניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ב-1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-253402300799, כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

שברירי שנייה לא שליליים ברזולוציה של ננו-שנייה. השדה הזה מייצג את החלק של משך הזמן בננו-שניות, ולא מהווה חלופה לשניות. גם אם ערכי השניות שליליים, ערכי הננו-שניות חייבים להיות לא שליליים ולייצג את הזמן שחלף. הערך חייב להיות בין 0 ל-999,999,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

מצב השילוב של Google Pay בדומיין אינטרנט של מוכר או באפליקציית Android.

טיפוסים בני מנייה (enum)
INTEGRATION_STATE_UNSPECIFIED לא צוין סטטוס השילוב.
NOT_STARTED הסטטוס הזה מציין שהאפליקציה ל-Android משויכת למפתח (ב-חנות Play), אבל המפתח לא התחיל תהליך שילוב עבורה.
INCOMPLETE המפתח עדיין לא שלח את השילוב לבדיקה, והוא גם לא הושלם (למשל, חסרים מסמכים תומכים).
READY_FOR_REVIEW המפתח עדיין לא שלח את השילוב לבדיקה, אבל הוא מוכן לבדיקה (לדוגמה, מסמכים תומכים הועלו).
UNDER_REVIEW הבקשה להפעלת השילוב ממתינה לבדיקה של האדמין.
NEED_INFO במהלך הבדיקה, אדמין ב-gTech צריך לספק מידע נוסף לגבי השילוב.
ACTIVE השילוב פעיל כרגע.
DELETED המוֹכר מחק את השילוב.
REJECTED השילוב נדחה.

IntegrationType

סוג השילוב של שילוב Google Pay.

טיפוסים בני מנייה (enum)
INTEGRATION_TYPE_UNSPECIFIED סוג השילוב לא צוין.
DIRECT_INTEGRATION סוג השילוב הוא שילוב ישיר.
PAYMENT_SERVICE_PROVIDER סוג השילוב הוא ספק שירותי תשלום.

DocumentType

סוג המסמך.

טיפוסים בני מנייה (enum)
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 של המסמך.

טיפוסים בני מנייה (enum)
MIME_TYPE_UNSPECIFIED לא צוין סוג ה-MIME.
JPEG סוג ה-MIME הוא JPEG.
PNG סוג ה-MIME הוא PNG.
WEBP סוג ה-MIME הוא WEBP.
PDF סוג ה-MIME הוא PDF.

סכימת הפלט

הודעת תגובה ל-CreateGooglePayIntegration.

CreateGooglePayIntegrationResponse

ייצוג ב-JSON 
{
  "integrationState": enum (IntegrationState)
}
שדות
integrationState

enum (IntegrationState)

מצב השילוב של Google Pay.

IntegrationState

מצב השילוב של Google Pay בדומיין אינטרנט של מוכר או באפליקציית Android.

טיפוסים בני מנייה (enum)
INTEGRATION_STATE_UNSPECIFIED לא צוין סטטוס השילוב.
NOT_STARTED הסטטוס הזה מציין שהאפליקציה ל-Android משויכת למפתח (ב-חנות Play), אבל המפתח לא התחיל תהליך שילוב עבורה.
INCOMPLETE המפתח עדיין לא שלח את השילוב לבדיקה, והוא גם לא הושלם (למשל, חסרים מסמכים תומכים).
READY_FOR_REVIEW המפתח עדיין לא שלח את השילוב לבדיקה, אבל הוא מוכן לבדיקה (לדוגמה, מסמכים תומכים הועלו).
UNDER_REVIEW הבקשה להפעלת השילוב ממתינה לבדיקה של האדמין.
NEED_INFO במהלך הבדיקה, אדמין ב-gTech צריך לספק מידע נוסף לגבי השילוב.
ACTIVE השילוב פעיל כרגע.
DELETED המוֹכר מחק את השילוב.
REJECTED השילוב נדחה.

הערות על כלים

רמז הרסני: ❌ | רמז אידמפוטנטי: ❌ | רמז לקריאה בלבד: ❌ | רמז לעולם פתוח: ❌