MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: update_merchant

Actualiza campos específicos de un comercio existente. Los campos admitidos incluyen display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email y customer_support_phone.

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

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

Esquema de entrada

Es el 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. Es el ID del comercio que se actualizará.

Campo de unión _display_name.

_display_name puede ser una de las siguientes opciones:
displayName

string

El nombre que se muestra del comerciante.

Campo de unión _mcc.

_mcc puede ser una de las siguientes opciones:
mcc

enum (Mcc)

Es el MCC (código de categoría del comercio) del comercio.

Campo de unión _corporate_website_url.

_corporate_website_url puede ser una de las siguientes opciones:
corporateWebsiteUrl

string

Es el sitio web corporativo del comercio.

Campo de unión _customer_support_website_url.

_customer_support_website_url puede ser una de las siguientes opciones:
customerSupportWebsiteUrl

string

Sitio web de asistencia al cliente del comercio.

Campo de unión _customer_support_email.

_customer_support_email puede ser una de las siguientes opciones:
customerSupportEmail

string

Es el correo electrónico de asistencia al cliente del comercio.

Campo de unión _customer_support_phone.

_customer_support_phone puede ser una de las siguientes opciones:
customerSupportPhone

string

Es el teléfono de asistencia al cliente del comercio.

Mcc

Es el código de categoría del comercio (MCC) de un comercio.

Enums
OTHERS Otros
MISC_FOOD_STORES Tiendas de alimentos varios: minimercados y mercados especializados
MISC_APPAREL Tiendas de ropa y accesorios varios
ARTISTS_SUPPLY Tiendas de artículos para artistas y artesanías
AUTOMOTIVE_PARTS Tiendas de repuestos 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 suministros fotográficos y cámaras
COMPUTERS_EQUIPMENT Computadoras, equipos periféricos para computadoras y software
COMPUTER_SOFTWARE Tiendas de software para computadoras
ELECTRONICS_SALES Ventas de electrónica
GIFT_SHOPS Tiendas de regalos, recuerdos y tarjetas
EATING_PLACES Lugares para comer y restaurantes
MISC_GENERAL_MERCHANDISE Artículos generales varios
HOME_SUPPLY 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 inmobiliarios: alquileres
MISC_PERSONAL_SERVICES Servicios personales diversos, no clasificados en otra parte
SPORTING_GOODS Tiendas de deportes
STATIONERY_OFFICE_SUPPLIES Papelería, artículos de oficina, papel para impresión y escritura
THEATRICAL_TICKET_AGENCIES Agencias de venta de entradas para cine
TIMESHARES Tiempos compartidos
TOURIST_ATTRACTIONS Atracciones y exhibiciones turísticas
HOBBY_TOY_GAME_SHOPS Tiendas de pasatiempos, juguetes y juegos
PET_SHOPS Tiendas de mascotas, tiendas de alimentos y suministros para mascotas
OTHER_LODGING Otros alojamientos: hoteles, moteles y complejos turísticos
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 administradas por el Gobierno (solo para la región de EE.UU.)
GOVERNMENT_LICENSED_CASINOS_US Casinos en línea con licencia gubernamental (juegos de apuestas en línea) (solo para la región de EE.UU.)
BETTING Apuestas (incluidos billetes de lotería, fichas de casino, apuestas fuera del hipódromo y apuestas)
GOVERNMENT_OWNED_LOTTERIES_NON_US Loterías administradas por el Gobierno (regiones fuera de EE.UU.)

Esquema de salida

Mensaje de respuesta para UpdateMerchant.

UpdateMerchantResponse

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

enum (State)

Es el estado del comercio actualizado.

Estado

Es el estado de un comercio.

Enums
STATE_UNSPECIFIED El estado del comercio no está especificado.
VERIFIED El comercio está verificado y aprobado.
IN_REVIEW La edición del perfil de comercio está en proceso de revisión.
REJECTED Se rechaza la edición del perfil del comerciante.
INCOMPLETE_SIGNUP El perfil del comercio está incompleto.
SANCTIONS_HIT El perfil de comercio está sujeto a sanciones.
READY_FOR_REVIEW El perfil del comercio está completo y listo para su revisión.
DISABLED El perfil del comercio 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 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: ❌