MCP Tools Reference: paydeveloper.googleapis.com

Strumento: update_merchant

Aggiorna campi specifici di un commerciante esistente. I campi supportati includono display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email e customer_support_phone.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP update_merchant.

Richiesta 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
}'

Schema di input

Messaggio di richiesta per UpdateMerchant.

UpdateMerchantFacadeRequest

Rappresentazione 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.
}
Campi
merchantId

string

Obbligatorio. L'ID del commerciante da aggiornare.

Campo unione _display_name.

_display_name può essere solo uno dei seguenti tipi:

displayName

string

Il nome visualizzato del commerciante.

Campo unione _mcc.

_mcc può essere solo uno dei seguenti tipi:

mcc

enum (Mcc)

Il codice MCC (Merchant Category Code) del commerciante.

Campo unione _corporate_website_url.

_corporate_website_url può essere solo uno dei seguenti tipi:

corporateWebsiteUrl

string

Il sito web aziendale del commerciante.

Campo unione _customer_support_website_url.

_customer_support_website_url può essere solo uno dei seguenti tipi:

customerSupportWebsiteUrl

string

Il sito web dell'assistenza clienti del commerciante.

Campo unione _customer_support_email.

_customer_support_email può essere solo uno dei seguenti tipi:

customerSupportEmail

string

L'email dell'assistenza clienti del commerciante.

Campo unione _customer_support_phone.

_customer_support_phone può essere solo uno dei seguenti tipi:

customerSupportPhone

string

Il numero di telefono dell'assistenza clienti del commerciante.

Mcc

Il codice di categoria commerciante (Merchant Category Code, MCC) di un commerciante.

Enum
OTHERS Altri
MISC_FOOD_STORES Negozi di alimentari vari: minimarket e mercati specializzati
MISC_APPAREL Negozi di abbigliamento e accessori vari
ARTISTS_SUPPLY Negozi di forniture per artisti e artigianato
AUTOMOTIVE_PARTS Negozi di ricambi e accessori per auto
HEALTH_AND_BEAUTY Negozio di prodotti di bellezza e per il benessere
BOOKS_PERIODICALS Libri, periodici e quotidiani
CAMERA_STORES Negozi di fotocamere e forniture fotografiche
COMPUTERS_EQUIPMENT Computer, apparecchiature periferiche per computer, software
COMPUTER_SOFTWARE Negozi di software per computer
ELECTRONICS_SALES Vendite di elettronica
GIFT_SHOPS Negozi di carte, regali, novità e souvenir
EATING_PLACES Ristoranti e luoghi dove mangiare
MISC_GENERAL_MERCHANDISE Prodotti generici vari
HOME_SUPPLY Negozi magazzino di forniture per la casa
COMPUTER_NETWORK_SERVICES Servizi di rete per computer
DIGITAL_GOODS_MEDIA Prodotti digitali: libri, film, musica
DIGITAL_GOODS_GAMES Prodotti digitali: giochi
DIGITAL_GOODS_APPLICATIONS Prodotti digitali: applicazioni (esclusi i giochi)
POLITICAL_ORGANIZATIONS Organizzazioni politiche
CHARITABLE_ORGANIZATIONS Organizzazioni di beneficenza e di servizi sociali
DRUG_STORES Farmacie e negozi di generi vari
REAL_ESTATE_RENTALS Agenti immobiliari e gestori - Affitti
MISC_PERSONAL_SERVICES Servizi personali vari, non classificati altrove
SPORTING_GOODS Negozi di articoli sportivi
STATIONERY_OFFICE_SUPPLIES Cancelleria, forniture per ufficio, carta per stampa e scrittura
THEATRICAL_TICKET_AGENCIES Agenzie di biglietti teatrali
TIMESHARES Multiproprietà
TOURIST_ATTRACTIONS Attrazioni turistiche e mostre
HOBBY_TOY_GAME_SHOPS Negozi di hobby, giocattoli e giochi
PET_SHOPS Negozi di animali, alimenti e forniture per animali
OTHER_LODGING Altri alloggi: hotel, motel, resort
TELECOMMUNICATION_SERVICES Servizi di telecomunicazione
TRANSPORTATION_SERVICES Servizi di trasporto
OTHER_AIRLINES Altre compagnie aeree
TRAVEL_AGENCIES Agenzie di viaggi e tour operator
GOVERNMENT_OWNED_LOTTERIES_US Lotterie di proprietà statale (solo regione USA)
GOVERNMENT_LICENSED_CASINOS_US Casinò online con licenza governativa (giochi e scommesse online) (solo regione Stati Uniti)
BETTING Scommesse (inclusi biglietti della lotteria, chip per giochi da casinò, scommesse ippiche e puntate)
GOVERNMENT_OWNED_LOTTERIES_NON_US Lotterie di proprietà statale (regione non statunitense)

Schema di output

Messaggio di risposta per UpdateMerchant.

UpdateMerchantResponse

Rappresentazione JSON
{
  "state": enum (State)
}
Campi
state

enum (State)

Lo stato del commerciante aggiornato.

Stato

La condizione di un mercante.

Enum
STATE_UNSPECIFIED Lo stato del commerciante non è specificato.
VERIFIED Il commerciante è verificato e approvato.
IN_REVIEW La modifica del profilo commerciante è in corso di revisione.
REJECTED La modifica del profilo del commerciante viene rifiutata.
INCOMPLETE_SIGNUP Il profilo commerciante non è completo.
SANCTIONS_HIT Il profilo commerciante è soggetto a sanzioni.
READY_FOR_REVIEW Il profilo del commerciante è completo e pronto per la revisione.
DISABLED Il profilo commerciante è disattivato/inattivo.

Annotazioni dello strumento

Le annotazioni dello strumento vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti non attendibili, ma possono essere utilizzati per decidere quando inviare a un utente una richiesta di conferma.

Oltre alla stringa del titolo, sono definiti i seguenti suggerimenti booleani:

  • readOnlyHint: se è true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se è true, lo strumento può eseguire azioni distruttive. Se il valore è false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se è true, chiamare ripetutamente lo strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se è true, lo strumento può interagire con un "open world" di entità esterne. Se è false, lo strumento può interagire solo con le entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria no.

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ❌ | Suggerimento open world: ❌