MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: create_merchant

Crea un comercio nuevo con la cuenta autenticada. DEBES pedirle al usuario que proporcione la información necesaria para crear el comercio. No llames a esta herramienta hasta que hayas intentado recopilar la información requerida 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 el siguiente ejemplo, se muestra cómo usar curl para invocar 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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Es el mensaje de solicitud para CreateMerchant.

CreateMerchantRequest

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

object (Merchant)

Obligatorio. Es la información básica del comercio que se 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. Es el número de teléfono de asistencia al cliente del comercio.
state

enum (State)

Solo salida. Es el estado 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 Artículos digitales: Libros, películas y música
DIGITAL_GOODS_GAMES Artículos 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 estatales (solo para la región de EE.UU.)
GOVERNMENT_LICENSED_CASINOS_US Casinos en línea con licencia del Gobierno (juegos de apuestas en línea) (solo para la región de EE.UU.)
BETTING Apuestas (incluidos boletos de lotería, fichas de juegos de casino, apuestas fuera de la pista y apuestas)
GOVERNMENT_OWNED_LOTTERIES_NON_US Loterías estatales (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

Es el ID del comercio 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

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