MCP Tools Reference: paydeveloper.googleapis.com

Ferramenta: list_merchants

Recupera uma lista de todos os perfis comerciais de comerciantes do Google Pay associados à conta autenticada.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta list_merchants MCP.

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

Esquema de entrada

Mensagem de solicitação para listar comerciantes.

Esquema de saída

Mensagem de resposta para listar comerciantes.

ListMerchantsResponse

Representação JSON
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
Campos
merchants[]

object (Merchant)

As informações básicas do comerciante a que o usuário tem acesso.

Comerciante

Representação JSON
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Campos
merchantId

string

Apenas saída. O identificador exclusivo do comerciante.

displayName

string

Obrigatório. O nome de exibição do comerciante.

regionCode

string

Obrigatório. O código da região do local da empresa do comerciante. O formato é o código de região CLDR Unicode, por exemplo, "US". A Índia ("IN") não é aceita.

mcc

enum (Mcc)

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

corporateWebsiteUrl

string

Obrigatório. O site corporativo do comerciante.

customerSupportWebsiteUrl

string

Obrigatório. O site de suporte ao cliente da loja.

customerSupportEmail

string

Obrigatório. O e-mail de suporte ao cliente do comerciante.

customerSupportPhone

string

Obrigatório. O número de telefone do suporte ao cliente do comerciante.

state

enum (State)

Apenas saída. O estado 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ão fora dos EUA)

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 revisão.
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

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