MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: create_merchant

Crea un nuevo comerciante con la cuenta autenticada. Es IMPRESCINDIBLE solicitar al usuario que proporcione la información necesaria para la creación del comerciante. Uno de los campos obligatorios es el código de categoría del comercio (MCC). Dado que la lista de MCC es larga, puedes presentar un subconjunto de opciones comunes, pero DEBES informar al usuario que hay más opciones disponibles y que puede solicitar la lista completa (p.ej., mostrando "X opciones más" o una sugerencia similar). Además, infórmale al usuario que puede proporcionar directamente el código de MCC de 4 dígitos (p.ej., 5499) si ya lo conoce y anímalo a que lo use. No llames a esta herramienta hasta que hayas intentado recopilar la información necesaria para la creación del comercio. Después de crear el comercio, DEBES presentarle al usuario la URL de las Condiciones del Servicio de la Business Console y pedirle que las acepte antes de que pueda realizar cualquier operación en este comercio.

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

Esquema de entrada

Mensaje de solicitud para CreateMerchant.

CreateMerchantRequest

Representación JSON 
{
  "merchant": {
    object (Merchant)
  }
}
Campos
merchant

object (Merchant)

Obligatorio. La información básica del comerciante a crear.

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 salida. Es el identificador único del comercio.
displayName

string

Obligatorio. Es el nombre visible del comercio.
regionCode

string

Obligatorio. Es el código de región de la ubicación de la empresa del comercio. El formato son los códigos de región CLDR de Unicode, p.ej., "US". No se admite la India ("IN").
mcc

enum (Mcc)

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

string

Obligatorio. Es el sitio web corporativo del comercio.
customerSupportWebsiteUrl

string

Obligatorio. Sitio web de asistencia al cliente del comercio.
customerSupportEmail

string

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

string

Obligatorio. El número de teléfono de atención al cliente del comerciante.
state

enum (State)

Solo salida. El estado del comerciante.

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.)

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 comercio.
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.

Esquema de salida

Es el mensaje de respuesta de CreateMerchant.

CreateMerchantResponse

Representación JSON 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
Campos
merchantId

string

El ID del comerciante creado.
state

enum (State)

Es el estado del comercio creado.
businessConsoleTosUrl

string

Solo salida. Es la URL de las CdC de Business Console. El usuario debe aceptar las Condiciones del Servicio de Business Console antes de poder realizar cualquier operación en el comercio.

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 comercio.
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.

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