MCP Tools Reference: paydeveloper.googleapis.com

Инструмент: create_google_pay_integration

Создает интеграцию Google Pay для конкретного продавца. Для выполнения этой операции пользователь должен принять Условия использования бизнес-консоли и Условия использования API Google Pay. Предварительная проверка этих условий не требуется. Если они не приняты, вызов инструмента завершится неудачей, и в сообщении об ошибке будут указаны URL-адреса условий использования, которые необходимо принять. В этом случае предоставьте пользователю URL-адреса для принятия и попросите его повторить попытку после принятия. Для взаимодействия с пользователем ПЕРЕД вызовом инструмента выполните следующие действия: 1. Сначала запросите у пользователя тип интеграции (в настоящее время поддерживается только веб-интеграция). - Запросите URL-адрес веб-сайта. # - Если тип интеграции — интеграция с приложением, запросите имя пакета приложения Android. 2. Затем запросите у пользователя тип интеграции: - Попросите пользователя выбрать Gateway, если он использует одного из поддерживаемых нами поставщиков платежных услуг (PSP: https://developers.google.com/pay/api#participating-processors ), в противном случае выберите Direct. 3. Для ВСЕХ типов интеграции (прямая или шлюзовая): - Попросите пользователя загрузить скриншоты (максимум 1 МБ) своего процесса покупки, интегрированного с API Google Pay. Процесс покупки должен быть проверен и одобрен до предоставления полного доступа к рабочей версии. Пример: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together . - Вы ОБЯЗАТЕЛЬНО должны попросить пользователя предоставить 5 подтверждающих скриншотов. Запрашивайте их ПО ОДНОМУ, чтобы обеспечить правильное сопоставление. Используйте ТОЛЬКО понятные описания перечислений при запросе. 4. Если тип интеграции прямой: - Вы ТАКЖЕ должны попросить пользователя предоставить документ о подтверждении соответствия PCI в формате PDF. Используйте ТОЛЬКО понятные описания перечислений при запросе. 5. Для каждого предоставленного файла попросите пользователя указать путь или имя документа, если он находится в текущем каталоге. Сопоставьте его с правильным типом документа и установите в поле имени описательное имя (например, 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
}'

Схема ввода

Запрос на создание интеграции Google Pay.

Создать запрос на интеграцию Google Pay

JSON-представление 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
Поля
merchantId

string

Обязательно. Идентификатор продавца, для которого необходимо добавить интеграцию Google Pay.

googlePayIntegration

object ( GooglePayIntegration )

Обязательно. Необходимо создать интеграцию с Google Pay.

Интеграция Google Pay

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

Имя пакета Android-приложения продавца.

Отметка времени

JSON-представление 
{
  "seconds": string,
  "nanos": integer
}
Поля
seconds

string ( int64 format)

Обозначает количество секунд UTC-времени с начала эпохи Unix 1970-01-01T00:00:00Z. Должно находиться в диапазоне от -62135596800 до 253402300799 включительно (что соответствует периоду с 0001-01-01T00:00:00Z по 9999-12-31T23:59:59Z).

nanos

integer

Неотрицательные доли секунды с разрешением в наносекунды. Это поле представляет собой наносекундную часть длительности, а не альтернативу секундам. Отрицательные значения секунд с дробными долями должны по-прежнему иметь неотрицательные значения в наносекундах, отсчитываемые вперед во времени. Должны быть в диапазоне от 0 до 999 999 999 включительно.

Интеграционный документ

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-приложением.

Перечисления
INTEGRATION_STATE_UNSPECIFIED Состояние интеграции не указано.
NOT_STARTED Это состояние характерно для случаев, когда приложение для Android связано с разработчиком (в Play Store), но разработчик еще не начал процесс интеграции.
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. Совет: Android не позволяет сделать снимок экрана, поэтому сделайте снимок экрана с помощью другого устройства.
POST_PURCHASE_SCREENSHOT Когда пользователь совершил успешную покупку.
PCI_ATTESTATION_DOCUMENT Документ о подтверждении соответствия стандартам PCI в формате PDF.

MIME-тип

MIME-тип документа.

Перечисления
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-приложением.

Перечисления
INTEGRATION_STATE_UNSPECIFIED Состояние интеграции не указано.
NOT_STARTED Это состояние характерно для случаев, когда приложение для Android связано с разработчиком (в Play Store), но разработчик еще не начал процесс интеграции.
INCOMPLETE Разработчик еще не отправил интеграцию на проверку, и она также не завершена (например, отсутствуют сопроводительные документы).
READY_FOR_REVIEW Разработчик еще не отправил интеграцию на проверку, но она готова к проверке (например, подтверждающие документы загружены).
UNDER_REVIEW Запрос на включение интеграции находится на рассмотрении администратора.
NEED_INFO В ходе проверки интеграции администратору gTech потребуется предоставить дополнительную информацию.
ACTIVE Интеграция в данный момент активна.
DELETED Интеграция удалена продавцом.
REJECTED Интеграция отклонена.

Аннотации инструментов

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ❌ | Подсказка только для чтения: ❌ | Подсказка об открытом мире: ❌