MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: list_merchants

Obtiene una lista completa de todos los comerciantes de Google Pay asociados a la cuenta autenticada. En función del rol del usuario en un comercio, los administradores pueden ver información detallada completa del comercio, mientras que los desarrolladores solo pueden ver información básica.

En el siguiente código de ejemplo se muestra cómo usar curl para llamar a la herramienta list_merchants de 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": "list_merchants",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensaje de solicitud para listar comerciantes.

ListMerchantsRequest

Representación JSON 
{
  "view": enum (MerchantView)
}
Campos
view

enum (MerchantView)

Opcional. Especifica el nivel de detalle que se debe devolver de cada comerciante.

MerchantView

El nivel de detalle que se devolverá de cada comerciante.

enumeraciones,
MERCHANT_VIEW_UNSPECIFIED El valor predeterminado o no definido. La API usará la vista BASIC de forma predeterminada.
MERCHANT_VIEW_BASIC Incluye información básica sobre el comerciante.
MERCHANT_VIEW_FULL Incluye todos los detalles sobre el comerciante.

Esquema de salida

Mensaje de respuesta para listar comerciantes.

ListMerchantsResponse

Representación JSON 
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
Campos
merchants[]

object (Merchant)

Los comerciantes a los que tiene acceso el usuario.

Comercio

Representación JSON 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Campos
merchantId

string

Solo de salida. El identificador único del comerciante.
displayName

string

Obligatorio. Nombre visible del comerciante.
regionCode

string

Obligatorio. El código de región de la ubicación de la empresa del comerciante. El formato es el de los códigos de región CLDR de Unicode (por ejemplo, "US"). No se admite la India ("IN").
mcc

enum (Mcc)

Obligatorio. El código de categoría del comercio (MCC) del comerciante.
corporateWebsiteUrl

string

Obligatorio. El sitio web corporativo del comerciante.
customerSupportWebsiteUrl

string

Obligatorio. El sitio web del servicio de asistencia del comerciante.
customerSupportEmail

string

Obligatorio. El correo del servicio de asistencia del comerciante.
customerSupportPhone

string

Obligatorio. El número de teléfono del servicio de asistencia del comerciante.
state

enum (State)

Solo de salida. Estado del comerciante.

Mcc

El código de categoría del comercio (MCC) de un comerciante.

enumeraciones,
OTHERS Otros
MISC_FOOD_STORES Tiendas de alimentación varias (supermercados de barrio y mercados especializados)
MISC_APPAREL Tiendas de ropa y accesorios varios
ARTISTS_SUPPLY Tiendas de manualidades y bellas artes
AUTOMOTIVE_PARTS Tiendas de piezas y accesorios para automóviles
HEALTH_AND_BEAUTY Tienda de salud y belleza
BOOKS_PERIODICALS Libros, publicaciones periódicas y periódicos
CAMERA_STORES Tiendas de cámaras y material fotográfico
COMPUTERS_EQUIPMENT Ordenadores, equipos periféricos informáticos y software
COMPUTER_SOFTWARE Tiendas de software
ELECTRONICS_SALES Ventas de electrónica
GIFT_SHOPS Tiendas de tarjetas, regalos, novedades y recuerdos
EATING_PLACES Restaurantes y otros establecimientos de comida
MISC_GENERAL_MERCHANDISE Productos generales varios
HOME_SUPPLY Grandes almacenes de suministros para el hogar
COMPUTER_NETWORK_SERVICES Servicios de redes informáticas
DIGITAL_GOODS_MEDIA Bienes digitales: libros, películas y música
DIGITAL_GOODS_GAMES Bienes digitales: juegos
DIGITAL_GOODS_APPLICATIONS Bienes digitales: aplicaciones (no incluye juegos)
POLITICAL_ORGANIZATIONS Organizaciones políticas
CHARITABLE_ORGANIZATIONS Organizaciones benéficas y de servicios sociales
DRUG_STORES Droguerías y farmacias
REAL_ESTATE_RENTALS Agentes y administradores de la propiedad inmobiliaria: alquileres
MISC_PERSONAL_SERVICES Servicios personales diversos, no clasificados en otra parte
SPORTING_GOODS Tiendas de deportes
STATIONERY_OFFICE_SUPPLIES Papelería, material de oficina, papel de impresión y de escritura
THEATRICAL_TICKET_AGENCIES Agencias de venta de entradas de cine
TIMESHARES Multipropiedades
TOURIST_ATTRACTIONS Atracciones turísticas y exposiciones
HOBBY_TOY_GAME_SHOPS Tiendas de hobbies, juguetes y juegos
PET_SHOPS Tiendas de animales de compañía, alimentos y accesorios para mascotas
OTHER_LODGING Otros alojamientos (hoteles, moteles y resorts)
TELECOMMUNICATION_SERVICES Servicios de telecomunicaciones
TRANSPORTATION_SERVICES Servicios de transporte
OTHER_AIRLINES Otras aerolíneas
TRAVEL_AGENCIES Agencias de viajes y operadores turísticos
GOVERNMENT_OWNED_LOTTERIES_US Loterías de propiedad estatal (solo en EE. UU.)
GOVERNMENT_LICENSED_CASINOS_US Casinos online con licencia gubernamental (juegos de azar y apuestas online) (solo en la región de EE. UU.)
BETTING Apuestas (incluidas las de lotería, las fichas de casino, las apuestas fuera de la pista y las apuestas)
GOVERNMENT_OWNED_LOTTERIES_NON_US Loterías de propiedad estatal (región no estadounidense)

Estado

El estado de un comerciante.

enumeraciones,
STATE_UNSPECIFIED El estado del comerciante no está especificado.
VERIFIED El comerciante está verificado y aprobado.
IN_REVIEW La edición del perfil de comerciante está en proceso de revisión.
REJECTED Se rechaza la edición del perfil de comerciante.
INCOMPLETE_SIGNUP El perfil de comerciante está incompleto.
SANCTIONS_HIT El perfil de comerciante infringe las sanciones.
READY_FOR_REVIEW El perfil de comerciante está completo y listo para revisarse.
DISABLED El perfil de comerciante está inhabilitado o inactivo.

Anotaciones de herramientas

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

Además de la cadena del título, se definen las siguientes sugerencias booleanas:

  • readOnlyHint: si es true, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: si es true, la herramienta puede realizar acciones destructivas. Si es false, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: si es true, llamar a la herramienta repetidamente con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: si es true, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es false, la herramienta solo podrá 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.

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