MCP Tools Reference: paydeveloper.googleapis.com

Narzędzie: create_google_pay_integration

Tworzy integrację Google Pay dla konkretnego sprzedawcy. Ta operacja wymaga zaakceptowania przez użytkownika Warunków korzystania z Business Console i Warunków korzystania z Google Pay API. Nie musisz ich sprawdzać z wyprzedzeniem. Jeśli nie zostały zaakceptowane, wywołanie narzędzia nie powiedzie się, a komunikat o błędzie będzie zawierać konkretne adresy URL Warunków korzystania z usługi, które należy zaakceptować. W takim przypadku wyświetl użytkownikowi adresy URL do zaakceptowania i poproś go o ponowną próbę po ich zaakceptowaniu. Aby wejść w interakcję z użytkownikiem PRZED wywołaniem narzędzia, wykonaj te czynności: 1. Najpierw poproś użytkownika o element integracji (obecnie obsługiwana jest tylko integracja internetowa). – Poproś o adres URL witryny. # – Jeśli element integracji to integracja aplikacji, poproś o nazwę pakietu aplikacji na Androida. 2. Następnie poproś użytkownika o podanie typu integracji: – jeśli użytkownik korzysta z jednego z obsługiwanych dostawców usług płatniczych (PSP: https://developers.google.com/pay/api#participating-processors), poproś go o wybranie opcji „Bramka”, w przeciwnym razie wybierz „Bezpośrednia”. 3. W przypadku WSZYSTKICH typów integracji (bezpośredniej lub z bramą płatności): – poproś użytkownika o przesłanie zrzutów ekranu (maks. 1 MB) procesu zakupu zintegrowanego z Google Pay API. Zanim uzyskają pełny dostęp wersji produkcyjnej, ich proces zakupu musi zostać sprawdzony i zatwierdzony. Przykłady: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together – MUSISZ poprosić użytkownika o przesłanie 5 zrzutów ekranu. Proś o nie PO KOLEI, aby mieć pewność, że są prawidłowo przypisane. Podczas zadawania pytań używaj TYLKO przyjaznych dla użytkownika opisów wyliczeń. 4. Jeśli typ integracji to Direct: - MUSISZ też poprosić użytkownika o przesłanie dokumentu potwierdzającego zgodność ze standardem PCI w formacie PDF. Podczas zadawania pytań używaj TYLKO przyjaznego dla użytkownika opisu wyliczenia. 5. W przypadku każdego podanego pliku poproś użytkownika o podanie ścieżki lub nazwy dokumentu, jeśli znajduje się on w bieżącym katalogu. Zmapuj go na prawidłowy typ dokumentu i ustaw w żądaniu pole nazwy na nazwę opisową (np. item_selection.png lub pci_attestation.pdf). Nie używaj tego narzędzia, dopóki nie spróbujesz zebrać wymaganych dokumentów dla wybranego typu integracji.

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie create_google_pay_integration MCP.

Żądanie 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
}'

Schemat danych wejściowych

Wiadomość z prośbą o wywołanie funkcji CreateGooglePayIntegration.

CreateGooglePayIntegrationRequest

Zapis JSON 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
Pola
merchantId

string

Wymagane. Identyfikator sprzedawcy, dla którego chcesz dodać integrację z Google Pay.
googlePayIntegration

object (GooglePayIntegration)

Wymagane. Integracja z Google Pay do utworzenia.

GooglePayIntegration

Zapis 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.
}
Pola
integrationState

enum (IntegrationState)

Tylko dane wyjściowe. Stan integracji sprzedawcy z Google Pay.
createTime

string (Timestamp format)

Tylko dane wyjściowe. Data utworzenia zasobu integracji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Kiedy zasób integracji został ostatnio zaktualizowany.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

Wymagane. Typ integracji Google Pay.
integrationDocuments[]

object (IntegrationDocument)

Wymagane. Tylko dane wejściowe. Dokumentacja integracji Google Pay.
Pole zbiorcze item. Element integracji. Musisz ustawić jedną z tych wartości. item może mieć tylko jedną z tych wartości:
webDomain

string

Domena internetowa sprzedawcy.
androidAppPackage

string

Nazwa pakietu aplikacji na Androida sprzedawcy.

Sygnatura czasowa

Zapis JSON 
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Reprezentuje sekundy czasu UTC od epoki uniksowej 1970-01-01T00:00:00Z. Musi mieścić się w przedziale od -62135596800 do 253402300799 (włącznie), co odpowiada zakresowi od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z.
nanos

integer

Nieujemne ułamki sekundy z dokładnością do nanosekund. To pole zawiera część czasu trwania w nanosekundach, a nie alternatywę dla sekund. Ujemne wartości sekund z ułamkami nadal muszą mieć nieujemne wartości nanosekund, które liczą czas do przodu. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

IntegrationDocument

Zapis JSON 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
Pola
name

string

Wymagane. Nazwa dokumentu.
data

string (bytes format)

Wymagane. Dane dokumentu.

Ciąg tekstowy zakodowany w formacie Base64.
documentType

enum (DocumentType)

Wymagane. Typ dokumentu.
mimeType

enum (MimeType)

Wymagane. Typ MIME dokumentu.

IntegrationState

Stan integracji Google Pay w przypadku domeny internetowej sprzedawcy lub aplikacji na Androida.

Wartości w polu enum
INTEGRATION_STATE_UNSPECIFIED Stan integracji jest nieokreślony.
NOT_STARTED Ten stan oznacza, że aplikacja na Androida jest powiązana z deweloperem (w Sklepie Play), ale deweloper nie rozpoczął jeszcze procesu integracji.
INCOMPLETE Deweloper nie przesłał jeszcze integracji do sprawdzenia i nie jest ona kompletna (np. brakuje dokumentów pomocniczych).
READY_FOR_REVIEW Deweloper nie przesłał jeszcze integracji do sprawdzenia, ale jest ona gotowa do sprawdzenia (np. przesłano dokumenty pomocnicze).
UNDER_REVIEW Prośba o włączenie integracji oczekuje na sprawdzenie przez administratora.
NEED_INFO Podczas weryfikacji administrator gTech musi podać więcej informacji o integracji.
ACTIVE Integracja jest obecnie aktywna.
DELETED Sprzedawca usunął integrację.
REJECTED Integracja zostanie odrzucona.

IntegrationType

Typ integracji integracji Google Pay.

Wartości w polu enum
INTEGRATION_TYPE_UNSPECIFIED Typ integracji nie jest określony.
DIRECT_INTEGRATION Typ integracji to integracja bezpośrednia.
PAYMENT_SERVICE_PROVIDER Typ integracji to dostawca usług płatniczych.

DocumentType

Typ dokumentu.

Wartości w polu enum
DOCUMENT_TYPE_UNSPECIFIED Typ dokumentu nie jest określony.
ITEM_SELECTION_SCREENSHOT Gdy użytkownik przegląda produkt lub usługę.
PRE_PURCHASE_SCREENSHOT Gdy użytkownik jest gotowy do dokonania zakupu.
PAYMENT_METHOD_SCREENSHOT Gdy użytkownik wybierze Google Pay jako formę płatności.
PAYMENT_INFO_SCREENSHOT Gdy użytkownikowi wyświetlają się informacje o płatnościach zapisane w Google Pay. Wskazówka: Android nie pozwala na zrobienie zrzutu ekranu, więc zrób zdjęcie ekranu za pomocą innego urządzenia.
POST_PURCHASE_SCREENSHOT Gdy użytkownik dokona zakupu.
PCI_ATTESTATION_DOCUMENT Dokument potwierdzający PCI w formacie PDF.

MimeType

Typ MIME dokumentu.

Wartości w polu enum
MIME_TYPE_UNSPECIFIED Typ MIME nie jest określony.
JPEG Typ MIME to JPEG.
PNG Typ MIME to PNG.
WEBP Typ MIME to WEBP.
PDF Typ MIME to PDF.

Schemat wyjściowy

Wiadomość odpowiedzi dla CreateGooglePayIntegration.

CreateGooglePayIntegrationResponse

Zapis JSON 
{
  "integrationState": enum (IntegrationState)
}
Pola
integrationState

enum (IntegrationState)

Stan integracji z Google Pay.

IntegrationState

Stan integracji Google Pay w przypadku domeny internetowej sprzedawcy lub aplikacji na Androida.

Wartości w polu enum
INTEGRATION_STATE_UNSPECIFIED Stan integracji jest nieokreślony.
NOT_STARTED Ten stan oznacza, że aplikacja na Androida jest powiązana z deweloperem (w Sklepie Play), ale deweloper nie rozpoczął jeszcze procesu integracji.
INCOMPLETE Deweloper nie przesłał jeszcze integracji do sprawdzenia i nie jest ona kompletna (np. brakuje dokumentów pomocniczych).
READY_FOR_REVIEW Deweloper nie przesłał jeszcze integracji do sprawdzenia, ale jest ona gotowa do sprawdzenia (np. przesłano dokumenty pomocnicze).
UNDER_REVIEW Prośba o włączenie integracji oczekuje na sprawdzenie przez administratora.
NEED_INFO Podczas weryfikacji administrator gTech musi podać więcej informacji o integracji.
ACTIVE Integracja jest obecnie aktywna.
DELETED Sprzedawca usunął integrację.
REJECTED Integracja zostanie odrzucona.

Adnotacje do narzędzi

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