MCP Tools Reference: paydeveloper.googleapis.com

Ferramenta: update_merchant

Atualiza campos específicos de um comerciante. Os campos aceitos incluem display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email e customer_support_phone.

O exemplo de código a seguir mostra como usar curl para chamar a ferramenta MCP update_merchant.

Solicitação 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

Mensagem de solicitação para UpdateMerchant.

UpdateMerchantFacadeRequest

Representação 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

Obrigatório. O ID do comerciante a ser atualizado.

Campo de união _display_name.

_display_name pode ser apenas de um dos tipos a seguir:

displayName

string

O nome de exibição do comerciante.

Campo de união _mcc.

_mcc pode ser apenas de um dos tipos a seguir:

mcc

enum (Mcc)

O MCC (código de categoria do comerciante) do comerciante.

Campo de união _corporate_website_url.

_corporate_website_url pode ser apenas de um dos tipos a seguir:

corporateWebsiteUrl

string

O site corporativo do comerciante.

Campo de união _customer_support_website_url.

_customer_support_website_url pode ser apenas de um dos tipos a seguir:

customerSupportWebsiteUrl

string

O site de suporte ao cliente da loja.

Campo de união _customer_support_email.

_customer_support_email pode ser apenas de um dos tipos a seguir:

customerSupportEmail

string

O e-mail de suporte ao cliente do comerciante.

Campo de união _customer_support_phone.

_customer_support_phone pode ser apenas de um dos tipos a seguir:

customerSupportPhone

string

O telefone de suporte ao cliente do comerciante.

Mcc

O código de categoria do comerciante (MCC) de um comerciante.

Tipos enumerados
OTHERS Outros
MISC_FOOD_STORES Outras lojas de alimentos: lojas de conveniência e mercados especializados
MISC_APPAREL Lojas de vestuário e acessórios diversos
ARTISTS_SUPPLY Lojas de artesanato e materiais artísticos
AUTOMOTIVE_PARTS Lojas de peças e acessórios automotivos
HEALTH_AND_BEAUTY Centro de saúde e beleza
BOOKS_PERIODICALS Livros, periódicos e jornais
CAMERA_STORES Lojas de câmeras e acessórios fotográficos
COMPUTERS_EQUIPMENT Computadores, equipamentos periféricos de computador, software
COMPUTER_SOFTWARE Lojas de software de computador
ELECTRONICS_SALES Vendas de eletrônicos
GIFT_SHOPS Lojas de cartões, presentes, novidades e souvenirs
EATING_PLACES Estabelecimentos para refeições e restaurantes
MISC_GENERAL_MERCHANDISE Produtos gerais diversos
HOME_SUPPLY Atacadistas de materiais para casa
COMPUTER_NETWORK_SERVICES Serviços de rede de computadores
DIGITAL_GOODS_MEDIA Produtos digitais: livros, filmes e músicas
DIGITAL_GOODS_GAMES Produtos digitais: jogos
DIGITAL_GOODS_APPLICATIONS Produtos digitais: aplicativos (exceto jogos)
POLITICAL_ORGANIZATIONS Organizações políticas
CHARITABLE_ORGANIZATIONS Organizações de serviços sociais e beneficentes
DRUG_STORES Drogarias e farmácias
REAL_ESTATE_RENTALS Corretores e agentes imobiliários - Aluguéis
MISC_PERSONAL_SERVICES Serviços pessoais diversos, sem classificação em outro lugar
SPORTING_GOODS Lojas de materiais esportivos
STATIONERY_OFFICE_SUPPLIES Papelaria, artigos para escritório, impressão e redação
THEATRICAL_TICKET_AGENCIES Agências de venda de ingressos de teatro
TIMESHARES Participação acionária
TOURIST_ATTRACTIONS Atrações e exposições turísticas
HOBBY_TOY_GAME_SHOPS Lojas de brinquedos, jogos e hobbies
PET_SHOPS Pet shops, lojas de alimentos e produtos para animais de estimação
OTHER_LODGING Outros alojamentos: hotéis, motéis e resorts
TELECOMMUNICATION_SERVICES Serviços de telecomunicações
TRANSPORTATION_SERVICES Serviços de transporte
OTHER_AIRLINES Outras companhias aéreas
TRAVEL_AGENCIES Agências de viagem e operadoras de turismo
GOVERNMENT_OWNED_LOTTERIES_US Loterias estatais (somente na região dos EUA)
GOVERNMENT_LICENSED_CASINOS_US Cassinos on-line licenciados pelo governo (jogos de azar on-line) (somente na região dos EUA)
BETTING Apostas (incluindo bilhetes de loteria, fichas de jogos de cassino, apostas fora das pistas e apostas)
GOVERNMENT_OWNED_LOTTERIES_NON_US Loterias estatais (regiões fora dos EUA)

Esquema de saída

Mensagem de resposta para UpdateMerchant.

UpdateMerchantResponse

Representação JSON
{
  "state": enum (State)
}
Campos
state

enum (State)

O estado do comerciante atualizado.

Estado

O estado de um comerciante.

Tipos enumerados
STATE_UNSPECIFIED O estado do comerciante não foi especificado.
VERIFIED O comerciante foi verificado e aprovado.
IN_REVIEW A edição do perfil do comerciante está em análise.
REJECTED A edição do perfil do comerciante é rejeitada.
INCOMPLETE_SIGNUP O perfil do comerciante está incompleto.
SANCTIONS_HIT O perfil do comerciante viola as sanções.
READY_FOR_REVIEW O perfil do comerciante está completo e pronto para revisão.
DISABLED O perfil do comerciante está desativado/inativo.

Anotações de ferramentas

As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um pedido de confirmação pode ser enviado a um usuário.

Além da string de título, as seguintes dicas booleanas são definidas da seguinte maneira:

  • readOnlyHint: se for "true", a ferramenta não vai modificar o ambiente. (Padrão: falso).
  • destructiveHint: se for "true", a ferramenta poderá realizar ações destrutivas. Se for "false", a ferramenta só poderá realizar ações de adição. Padrão: verdadeiro.
  • idempotentHint: se for "true", chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente dela. (Padrão: falso).
  • openWorldHint: se for "true", a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for "false", a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌