MCP Tools Reference: paydeveloper.googleapis.com

Strumento: create_merchant

Crea un nuovo commerciante con l'account autenticato. DEVI chiedere all'utente di fornire le informazioni necessarie per la creazione del commerciante. Non chiamare questo strumento finché non hai tentato di raccogliere le informazioni richieste per la creazione del commerciante. Dopo aver creato il commerciante, DEVI presentare all'utente l'URL dei Termini di servizio della Business Console e chiedergli di accettarli prima di poter eseguire qualsiasi operazione su questo commerciante.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP create_merchant.

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

Schema di input

Messaggio di richiesta per CreateMerchant.

CreateMerchantRequest

Rappresentazione JSON 
{
  "merchant": {
    object (Merchant)
  }
}
Campi
merchant

object (Merchant)

Obbligatorio. Le informazioni di base del commerciante da creare.

Commerciante

Rappresentazione JSON 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Campi
merchantId

string

Solo output. L'identificatore univoco del commerciante.
displayName

string

Obbligatorio. Il nome visualizzato del commerciante.
regionCode

string

Obbligatorio. Il codice regione della sede dell'attività commerciale del commerciante. Il formato è quello dei codici regione Unicode CLDR, ad esempio "US". L'India ("IN") non è supportata.
mcc

enum (Mcc)

Obbligatorio. Il codice categoria commerciante (Merchant Category Code, MCC) del commerciante.
corporateWebsiteUrl

string

Obbligatorio. Il sito web aziendale del commerciante.
customerSupportWebsiteUrl

string

Obbligatorio. Il sito web dell'assistenza clienti del commerciante.
customerSupportEmail

string

Obbligatorio. L'email dell'assistenza clienti del commerciante.
customerSupportPhone

string

Obbligatorio. Il numero di telefono dell'assistenza clienti del commerciante.
state

enum (State)

Solo output. Lo stato del commerciante.

Mcc

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

Enum
OTHERS Altro
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, articoli di 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 Altre strutture ricettive: 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 Stati Uniti)
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à del governo (regione non statunitense)

Stato

Lo stato di un commerciante.

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.

Schema di output

Messaggio di risposta per CreateMerchant.

CreateMerchantResponse

Rappresentazione JSON 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
Campi
merchantId

string

L'ID commerciante del commerciante creato.
state

enum (State)

Lo stato del commerciante creato.
businessConsoleTosUrl

string

Solo output. L'URL dei Termini di servizio di Business Console. L'utente deve accettare i Termini di servizio della Business Console prima di poter eseguire qualsiasi operazione sul commerciante.

Stato

Lo stato di un commerciante.

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

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