MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: create_google_pay_integration

Crea una integración de Google Pay para un comercio específico. Esta operación requiere que el usuario haya aceptado las Condiciones del Servicio de Business Console y las Condiciones del Servicio de la API de Google Pay. No es necesario que realices estas verificaciones de forma preventiva. Si no se aceptaron, la llamada a la herramienta fallará y el mensaje de error contendrá las URLs específicas de las Condiciones del Servicio que se deben aceptar. Si esto ocurre, muéstrale las URLs al usuario para que las acepte y pídele que vuelva a intentarlo una vez que las acepte. Sigue esta secuencia para interactuar con el usuario ANTES de llamar a la herramienta: 1. Primero, pregúntale al usuario por el elemento de integración (por el momento, solo se admite la integración web). - Solicita la URL del sitio web. # - Si el elemento de integración es Integración de la app, pregunta el nombre del paquete de la app para Android. 2. Luego, pregúntale al usuario el tipo de integración: - Dile al usuario que elija Gateway si usa uno de nuestros proveedores de servicios de pago (PSP: https://developers.google.com/pay/api#participating-processors) admitidos. De lo contrario, que elija Directo. 3. Para TODOS los tipos de integración (directa o de puerta de enlace): - Indícale al usuario que suba capturas de pantalla (máximo 1 MB) de su flujo de compra integrado con la API de Google Pay. Se debe revisar y aprobar su flujo de compra antes de que se le otorgue acceso a producción completo. Ejemplos: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - DEBES pedirle al usuario que proporcione 5 capturas de pantalla de respaldo. Pídele que los proporcione UNO POR UNO para garantizar la asignación correcta. Cuando hagas preguntas, usa SOLO las descripciones de enumeración fáciles de usar. 4. Si el tipo de integración es Direct, TAMBIÉN debes pedirle al usuario que proporcione el documento de certificación del PCI en formato PDF. Cuando hagas preguntas, usa SOLO la descripción de enumeración fácil de usar. 5. Para cada archivo proporcionado, pídele al usuario que proporcione la ruta de acceso o el nombre del documento si se encuentra en el directorio actual. Asigna el mapa al DocumentType correcto y establece el campo name en un nombre descriptivo (p.ej., item_selection.png o pci_attestation.pdf) en la solicitud. No llames a esta herramienta hasta que hayas intentado recopilar los documentos requeridos para el tipo de integración seleccionado.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP create_google_pay_integration.

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

Esquema de entrada

Es el mensaje de solicitud para CreateGooglePayIntegration.

CreateGooglePayIntegrationRequest

Representación JSON 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
Campos
merchantId

string

Obligatorio. Es el ID del comercio para el que se agregará la integración de Google Pay.
googlePayIntegration

object (GooglePayIntegration)

Obligatorio. Es la integración de Google Pay que se creará.

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

Es el estado de integración de Google Pay de un dominio web de comercio o una 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 ya está lista (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.
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.

Esquema de salida

Es el mensaje de respuesta de CreateGooglePayIntegration.

CreateGooglePayIntegrationResponse

Representación JSON 
{
  "integrationState": enum (IntegrationState)
}
Campos
integrationState

enum (IntegrationState)

Es el estado de integración de la integración de Google Pay.

IntegrationState

Es el estado de integración de Google Pay de un dominio web de comercio o una 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 ya está lista (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.
DELETED El comercio borró la integración.
REJECTED Se rechaza la integración.

Anotaciones de herramientas

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