MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: update_merchant

Actualiza campos específicos de un comerciante. Entre los campos admitidos se incluyen display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email y customer_support_phone.

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

Esquema de entrada

Mensaje de solicitud de UpdateMerchant.

UpdateMerchantFacadeRequest

Representación JSON 
{
  "merchantId": string,

  // Union field _display_name can be only one of the following:
  "displayName": string
  // End of list of possible types for union field _display_name.

  // Union field _mcc can be only one of the following:
  "mcc": enum (Mcc)
  // End of list of possible types for union field _mcc.

  // Union field _corporate_website_url can be only one of the following:
  "corporateWebsiteUrl": string
  // End of list of possible types for union field _corporate_website_url.

  // Union field _customer_support_website_url can be only one of the following:
  "customerSupportWebsiteUrl": string
  // End of list of possible types for union field _customer_support_website_url.

  // Union field _customer_support_email can be only one of the following:
  "customerSupportEmail": string
  // End of list of possible types for union field _customer_support_email.

  // Union field _customer_support_phone can be only one of the following:
  "customerSupportPhone": string
  // End of list of possible types for union field _customer_support_phone.
}
Campos
merchantId

string

Obligatorio. El ID del comerciante que se va a actualizar.

Campo de unión _display_name.

_display_name solo puede ser una de estas dos opciones:
displayName

string

Nombre visible del comerciante.

Campo de unión _mcc.

_mcc solo puede ser una de estas dos opciones:
mcc

enum (Mcc)

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

Campo de unión _corporate_website_url.

_corporate_website_url solo puede ser una de estas dos opciones:
corporateWebsiteUrl

string

El sitio web corporativo del comerciante.

Campo de unión _customer_support_website_url.

_customer_support_website_url solo puede ser una de estas dos opciones:
customerSupportWebsiteUrl

string

El sitio web del servicio de asistencia del comerciante.

Campo de unión _customer_support_email.

_customer_support_email solo puede ser una de estas dos opciones:
customerSupportEmail

string

El correo del servicio de asistencia del comerciante.

Campo de unión _customer_support_phone.

_customer_support_phone solo puede ser una de estas dos opciones:
customerSupportPhone

string

El teléfono del servicio de asistencia 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)

Esquema de salida

Mensaje de respuesta de UpdateMerchant.

UpdateMerchantResponse

Representación JSON 
{
  "state": enum (State)
}
Campos
state

enum (State)

Estado del comerciante actualizado.

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: ❌