MCP Tools Reference: paydeveloper.googleapis.com

Ferramenta: create_merchant

Cria um novo comerciante com a conta autenticada. Você PRECISA pedir ao usuário que forneça as informações necessárias para a criação do comerciante. Não chame essa ferramenta até tentar coletar as informações necessárias para a criação do comerciante. Depois que o comerciante for criado, você PRECISA apresentar o URL dos Termos de Serviço do Business Console ao usuário e instruí-lo a aceitar antes de realizar qualquer operação com esse comerciante.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta create_merchant 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": "create_merchant",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensagem de solicitação para CreateMerchant.

CreateMerchantRequest

Representação JSON 
{
  "merchant": {
    object (Merchant)
  }
}
Campos
merchant

object (Merchant)

Obrigatório. As informações básicas do comerciante a ser criado.

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.

Esquema de saída

Mensagem de resposta para "CreateMerchant".

CreateMerchantResponse

Representação JSON 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
Campos
merchantId

string

O ID do comerciante criado.
state

enum (State)

O estado do comerciante criado.
businessConsoleTosUrl

string

Apenas saída. O URL dos Termos de Serviço do Business Console. O usuário precisa aceitar os Termos de Serviço do Business Console antes de realizar qualquer operação no comerciante.

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: ❌