MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: list_google_pay_integrations

Devuelve el estado actual y los detalles de configuración de todas las integraciones de Google Pay asociadas a un ID de comerciante específico. Proporciona comentarios inmediatos sobre el estado de la integración y las revisiones de documentos. Además, DEBES informar al usuario que la integración se puede crear o actualizar en la Consola de Google Pay y la Billetera de Google (https://pay.google.com/business/console/).

En la siguiente muestra de código, se muestra cómo usar curl para llamar a la herramienta de MCP list_google_pay_integrations.

Solicitud de 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
}'

Esquema de entrada

Es el mensaje de solicitud para enumerar las integraciones de Google Pay de un comercio específico.

ListGooglePayIntegrationsRequest

Representación JSON 
{
  "merchantId": string
}
Campos
merchantId

string

Obligatorio. Es el ID del comercio para el que se enumerarán las integraciones.

Esquema de salida

Mensaje de respuesta para la lista de integraciones de Google Pay.

ListGooglePayIntegrationsResponse

Representación JSON 
{
  "googlePayIntegrations": [
    {
      object (GooglePayIntegration)
    }
  ]
}
Campos
googlePayIntegrations[]

object (GooglePayIntegration)

Son las integraciones de Google Pay del comercio.

GooglePayIntegration

Representación 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.
}
Campos
integrationState

enum (IntegrationState)

Solo salida. Es el estado de la integración de Google Pay del comercio.
createTime

string (Timestamp format)

Solo salida. Cuándo se creó el recurso de integración.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Cuándo se actualizó el recurso de integración por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

Obligatorio. Es el tipo de integración de la integración de Google Pay.
integrationDocuments[]

object (IntegrationDocument)

Obligatorio. Solo entrada. Son los documentos de integración de la integración de Google Pay.
Campo de unión item. Es el elemento de integración. Se debe establecer uno de estos parámetros. item puede ser solo uno de los parámetros siguientes:
webDomain

string

Es el dominio web del comercio.
androidAppPackage

string

Es el nombre del paquete de app para Android del comercio.

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de nanosegundos de la duración, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser un valor entre 0 y 999,999,999, inclusive.

IntegrationDocument

Representación JSON 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
Campos
name

string

Obligatorio. Es el nombre del documento.
data

string (bytes format)

Obligatorio. Son los datos del documento.

String codificada en base64.
documentType

enum (DocumentType)

Obligatorio. Es el tipo de documento.
mimeType

enum (MimeType)

Obligatorio. Es el tipo MIME del documento.

IntegrationState

El estado de integración de Google Pay de un dominio web de comercio o app para Android.

Enums
INTEGRATION_STATE_UNSPECIFIED El estado de la integración no está especificado.
NOT_STARTED Este estado se aplica cuando la app para Android está asociada con el desarrollador (en Play Store) y el desarrollador no ha iniciado ningún proceso de integración para ella.
INCOMPLETE El desarrollador aún no envió la integración para su revisión y tampoco está completa (p.ej., faltan documentos de respaldo).
READY_FOR_REVIEW El desarrollador aún no envió la integración para su revisión, pero está lista para revisarse (p.ej., se subieron los documentos de respaldo).
UNDER_REVIEW La solicitud de habilitación de la integración está pendiente de revisión por parte del administrador.
NEED_INFO Durante la revisión, el administrador de gTech necesita más información sobre la integración.
ACTIVE La integración está activa en este momento.
DELETED El comercio borró la integración.
REJECTED Se rechaza la integración.

IntegrationType

Es el tipo de integración de una integración de Google Pay.

Enums
INTEGRATION_TYPE_UNSPECIFIED No se especificó el tipo de integración.
DIRECT_INTEGRATION El tipo de integración es directa.
PAYMENT_SERVICE_PROVIDER El tipo de integración es proveedor de servicios de pago.

DocumentType

Es el tipo de documento.

Enums
DOCUMENT_TYPE_UNSPECIFIED No se especificó el tipo de documento.
ITEM_SELECTION_SCREENSHOT Cuando un usuario explora un artículo o servicio
PRE_PURCHASE_SCREENSHOT Cuando un usuario está listo para realizar una compra
PAYMENT_METHOD_SCREENSHOT Cuando un usuario selecciona Google Pay como forma de pago
PAYMENT_INFO_SCREENSHOT Cuando se le muestra al usuario la información de pago que guardó en Google Pay Nota: Android no te permitirá tomar una captura de pantalla de esta pantalla, así que toma una foto de la pantalla con otro dispositivo.
POST_PURCHASE_SCREENSHOT Cuando un usuario realiza una compra exitosa.
PCI_ATTESTATION_DOCUMENT Documento de certificación del PCI en formato PDF

MimeType

Es el tipo MIME de un documento.

Enums
MIME_TYPE_UNSPECIFIED No se especificó el tipo de MIME.
JPEG El tipo de MIME es JPEG.
PNG El tipo de MIME es PNG.
WEBP El tipo de MIME es WEBP.
PDF El tipo de MIME es PDF.

Anotaciones de herramientas

Las anotaciones de herramientas se envían a los clientes de MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se le puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, se definen las siguientes sugerencias booleanas:

  • readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌