MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: create_google_pay_integration

Crea una integración de Google Pay para un comerciante específico. Para realizar esta operación, el usuario debe haber aceptado los Términos del Servicio de la Consola para empresas y los Términos del Servicio de la API de Google Pay. No es necesario que los compruebes de forma preventiva. Si no se han aceptado, la llamada a la herramienta fallará y el mensaje de error contendrá las URLs específicas de los Términos del Servicio que se deben aceptar. Si esto ocurre, muestra las URLs al usuario para que las acepte y pídele que vuelva a intentarlo una vez que las haya aceptado. Sigue esta secuencia para interactuar con el usuario ANTES de llamar a la herramienta: 1. Primero, pregunta al usuario por el elemento de integración (por ahora, solo se admite la integración web). - Pide la URL del sitio web. # - Si el elemento de integración es una integración de aplicaciones, pregunta por el nombre del paquete de la aplicación Android. 2. A continuación, pregúntale al usuario qué tipo de integración quiere: - Dile que elija "Pasarela" si usa uno de nuestros proveedores de servicios de pago (PSP) admitidos (https://developers.google.com/pay/api#participating-processors). De lo contrario, que elija "Directa". 3. Para TODOS los tipos de integración (directa o de pasarela): - Indica al usuario que suba capturas de pantalla (1 MB como máximo) de su flujo de compra integrado con la API de Google Pay. Su flujo de compra debe revisarse y aprobarse antes de que se les conceda acceso completo a producción. Ejemplos: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - DEBES pedir al usuario que proporcione 5 capturas de pantalla de apoyo. Pídeles que lo hagan UNO POR UNO para asegurarse de que el mapeo sea correcto. 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 pedir al usuario que proporcione el documento de certificación PCI en formato PDF. Usa SOLO la descripción de enumeración fácil de usar cuando preguntes. 5. Por cada archivo proporcionado, pide al usuario que indique la ruta o el nombre del documento si está en el directorio actual. Asigna el valor al DocumentType correcto y asigna al campo name un nombre descriptivo (por ejemplo, item_selection.png o pci_attestation.pdf) en la solicitud. No llames a esta herramienta hasta que hayas intentado recoger los documentos necesarios para el tipo de integración seleccionado.

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

Curl Request 
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

Mensaje de solicitud de CreateGooglePayIntegration.

CreateGooglePayIntegrationRequest

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

string

Obligatorio. El ID de comerciante del comerciante al que se va a añadir la integración de Google Pay.
googlePayIntegration

object (GooglePayIntegration)

Obligatorio. La integración de Google Pay que se va a 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 de salida. Estado de la integración de Google Pay del comerciante.
createTime

string (Timestamp format)

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

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "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 de salida. Cuándo se actualizó el recurso de integración por última vez.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "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. Tipo de integración de Google Pay.
integrationDocuments[]

object (IntegrationDocument)

Obligatorio. Solo de entrada. Los documentos de integración de Google Pay.
Campo de unión item. El elemento de integración. Debe definirse uno de estos valores. item solo puede ser una de estas dos opciones:
webDomain

string

El dominio web del comerciante.
androidAppPackage

string

Nombre del paquete de aplicación Android del comerciante.

Marca de tiempo

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

string (int64 format)

Representa segundos de tiempo UTC desde el registro de tiempo de Unix 1970-01-01T00:00:00Z. Debe estar comprendido entre -62135596800 y 253402300799, ambos incluidos (lo que corresponde a 0001-01-01T00:00:00Z y 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo con 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 aún deben tener valores de nanosegundos no negativos que cuenten hacia adelante en el tiempo. Debe estar comprendido entre 0 y 999.999.999, ambos incluidos.

IntegrationDocument

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

string

Obligatorio. El nombre del documento.
data

string (bytes format)

Obligatorio. Los datos del documento.

Cadena codificada en Base64.
documentType

enum (DocumentType)

Obligatorio. Tipo de documento
mimeType

enum (MimeType)

Obligatorio. El tipo MIME del documento.

IntegrationState

El estado de integración de Google Pay de un dominio web o una aplicación Android de un comercio.

enumeraciones,
INTEGRATION_STATE_UNSPECIFIED El estado de la integración no está especificado.
NOT_STARTED Este estado se da cuando la aplicación Android está asociada al desarrollador (en Play Store) y el desarrollador no ha iniciado ningún proceso de integración para ella.
INCOMPLETE El desarrollador aún no ha enviado la integración para que se revise y tampoco está completa (por ejemplo, faltan documentos).
READY_FOR_REVIEW El desarrollador aún no ha enviado la integración a revisión, pero está lista para ello (por ejemplo, se han subido los documentos de respaldo).
UNDER_REVIEW La solicitud para habilitar la integración está pendiente de revisión por parte del administrador.
NEED_INFO El administrador de gTech necesita más información durante la revisión de la integración.
ACTIVE La integración está activa.
DELETED El comerciante elimina la integración.
REJECTED Se rechaza la integración.

IntegrationType

Tipo de integración de una integración de Google Pay.

enumeraciones,
INTEGRATION_TYPE_UNSPECIFIED El tipo de integración no está especificado.
DIRECT_INTEGRATION El tipo de integración es la integración directa.
PAYMENT_SERVICE_PROVIDER El tipo de integración es proveedor de servicios de pago.

DocumentType

El tipo de documento.

enumeraciones,
DOCUMENT_TYPE_UNSPECIFIED El tipo de documento no está especificado.
ITEM_SELECTION_SCREENSHOT Cuando un usuario está buscando un artículo o un servicio.
PRE_PURCHASE_SCREENSHOT Cuando un usuario está listo para hacer una compra.
PAYMENT_METHOD_SCREENSHOT Cuando un usuario selecciona Google Pay como método de pago.
PAYMENT_INFO_SCREENSHOT Cuando se muestra a un usuario la información para pagos que ha guardado en Google Pay. Nota: Android no te permitirá hacer una captura de pantalla de esta pantalla, así que haz una foto de la pantalla con otro dispositivo.
POST_PURCHASE_SCREENSHOT Cuando un usuario ha realizado una compra correctamente.
PCI_ATTESTATION_DOCUMENT Documento de confirmación de PCI en formato PDF.

MimeType

El tipo MIME de un documento.

enumeraciones,
MIME_TYPE_UNSPECIFIED El tipo MIME no está especificado.
JPEG El tipo MIME es JPEG.
PNG El tipo MIME es PNG.
WEBP El tipo MIME es WEBP.
PDF El tipo MIME es PDF.

Esquema de salida

Mensaje de respuesta de CreateGooglePayIntegration.

CreateGooglePayIntegrationResponse

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

enum (IntegrationState)

Estado de la integración de Google Pay.

IntegrationState

El estado de integración de Google Pay de un dominio web o una aplicación Android de un comercio.

enumeraciones,
INTEGRATION_STATE_UNSPECIFIED El estado de la integración no está especificado.
NOT_STARTED Este estado se da cuando la aplicación Android está asociada al desarrollador (en Play Store) y el desarrollador no ha iniciado ningún proceso de integración para ella.
INCOMPLETE El desarrollador aún no ha enviado la integración para que se revise y tampoco está completa (por ejemplo, faltan documentos).
READY_FOR_REVIEW El desarrollador aún no ha enviado la integración a revisión, pero está lista para ello (por ejemplo, se han subido los documentos de respaldo).
UNDER_REVIEW La solicitud para habilitar la integración está pendiente de revisión por parte del administrador.
NEED_INFO El administrador de gTech necesita más información durante la revisión de la integración.
ACTIVE La integración está activa.
DELETED El comerciante elimina la integración.
REJECTED Se rechaza la integración.

Anotaciones de herramientas

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