MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: create_merchant

Crea un nuevo comerciante con la cuenta autenticada. DEBES pedir al usuario que proporcione la información necesaria para crear la cuenta de comerciante. No llames a esta herramienta hasta que hayas intentado recoger la información necesaria para crear la cuenta de comerciante. Una vez que se haya creado el comerciante, DEBES mostrar al usuario la URL de los Términos del Servicio de la Consola para empresas e indicarle que los acepte para poder realizar operaciones en este comerciante.

En el siguiente ejemplo se muestra cómo usar curl para invocar la herramienta create_merchant 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": "create_merchant",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensaje de solicitud de CreateMerchant.

CreateMerchantRequest

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

object (Merchant)

Obligatorio. La información básica del comerciante que se va 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 de salida. El identificador único del comerciante.
displayName

string

Obligatorio. Nombre visible del comerciante.
regionCode

string

Obligatorio. 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 de Unicode CLDR (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 Productos 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 teatro
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 la región de 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 las pistas 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.

Esquema de salida

Mensaje de respuesta de CreateMerchant.

CreateMerchantResponse

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

string

El ID de comerciante del comerciante creado.
state

enum (State)

Estado del comerciante creado.
businessConsoleTosUrl

string

Solo de salida. URL de los Términos del Servicio de la Consola para empresas. El usuario debe aceptar los Términos del Servicio de la Consola para empresas antes de poder realizar operaciones en el comerciante.

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

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