MCP Tools Reference: paydeveloper.googleapis.com

Outil : update_merchant

Met à jour des champs spécifiques d'un marchand existant. Les champs acceptés incluent display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email et customer_support_phone.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP update_merchant.

Requête 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
}'

Schéma d'entrée

Message de requête pour UpdateMerchant.

UpdateMerchantFacadeRequest

Représentation 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.
}
Champs
merchantId

string

Obligatoire. ID du marchand à mettre à jour.

Champ d'union _display_name.

_display_name ne peut être qu'un des éléments suivants :
displayName

string

Nom à afficher du marchand.

Champ d'union _mcc.

_mcc ne peut être qu'un des éléments suivants :
mcc

enum (Mcc)

Code APE (activité principale exercée) du marchand.

Champ d'union _corporate_website_url.

_corporate_website_url ne peut être qu'un des éléments suivants :
corporateWebsiteUrl

string

Site Web de l'entreprise du marchand.

Champ d'union _customer_support_website_url.

_customer_support_website_url ne peut être qu'un des éléments suivants :
customerSupportWebsiteUrl

string

Site Web du service client du marchand.

Champ d'union _customer_support_email.

_customer_support_email ne peut être qu'un des éléments suivants :
customerSupportEmail

string

Adresse e-mail du service client du marchand.

Champ d'union _customer_support_phone.

_customer_support_phone ne peut être qu'un des éléments suivants :
customerSupportPhone

string

Numéro de téléphone du service client du marchand.

Mcc

Code de catégorie du marchand (CCM).

Enums
OTHERS Autres
MISC_FOOD_STORES Magasins d'alimentation divers : supérettes et marchés spécialisés
MISC_APPAREL Boutiques de vêtements et d'accessoires divers
ARTISTS_SUPPLY Magasins de fournitures artistiques et de loisirs créatifs
AUTOMOTIVE_PARTS Magasins de pièces et accessoires automobiles
HEALTH_AND_BEAUTY Boutique de santé et beauté
BOOKS_PERIODICALS Livres, périodiques et journaux
CAMERA_STORES Magasins d'appareils photo et de matériel photographique
COMPUTERS_EQUIPMENT Ordinateurs, périphériques informatiques, logiciels
COMPUTER_SOFTWARE Magasins de logiciels informatiques
ELECTRONICS_SALES Ventes d'appareils électroniques
GIFT_SHOPS Magasins de cartes, de cadeaux, de gadgets et de souvenirs
EATING_PLACES Restaurants et lieux de restauration
MISC_GENERAL_MERCHANDISE Divers articles généraux
HOME_SUPPLY Magasins d'aménagement de la maison
COMPUTER_NETWORK_SERVICES Services de réseau informatique
DIGITAL_GOODS_MEDIA Biens numériques : livres, films, musique
DIGITAL_GOODS_GAMES Produits numériques : jeux
DIGITAL_GOODS_APPLICATIONS Biens numériques : applications (hors jeux)
POLITICAL_ORGANIZATIONS Organisations politiques
CHARITABLE_ORGANIZATIONS Organisations caritatives et de services sociaux
DRUG_STORES Pharmacies et parapharmacies
REAL_ESTATE_RENTALS Agents et gestionnaires immobiliers : locations
MISC_PERSONAL_SERVICES Services personnels divers, non classés ailleurs
SPORTING_GOODS Magasins d'articles de sports
STATIONERY_OFFICE_SUPPLIES Papeterie, fournitures de bureau, papier pour l'impression et l'écriture
THEATRICAL_TICKET_AGENCIES Agences de billetterie pour les salles de cinéma
TIMESHARES Immobilier en multipropriété
TOURIST_ATTRACTIONS Attractions et expositions touristiques
HOBBY_TOY_GAME_SHOPS Magasins de loisirs, de jouets et de jeux
PET_SHOPS Magasins d'animaux, d'aliments et d'accessoires pour animaux
OTHER_LODGING Autres types d'hébergement – ​​Hôtels, motels, centres de villégiature
TELECOMMUNICATION_SERVICES Services de télécommunication
TRANSPORTATION_SERVICES Services de transport
OTHER_AIRLINES Autres compagnies aériennes
TRAVEL_AGENCIES Agences de voyages et voyagistes
GOVERNMENT_OWNED_LOTTERIES_US Loteries appartenant à l'État (région des États-Unis uniquement)
GOVERNMENT_LICENSED_CASINOS_US Casinos en ligne agréés par le gouvernement (jeux d'argent en ligne) (Région américaine uniquement)
BETTING Paris (y compris les billets de loterie, les jetons de jeux de casino, les paris hors course et les mises)
GOVERNMENT_OWNED_LOTTERIES_NON_US Loteries appartenant à l'État (hors États-Unis)

Schéma de sortie

Message de réponse pour UpdateMerchant.

UpdateMerchantResponse

Représentation JSON 
{
  "state": enum (State)
}
Champs
state

enum (State)

État du marchand mis à jour.

État

État d'un marchand.

Enums
STATE_UNSPECIFIED L'état du marchand n'est pas spécifié.
VERIFIED Le commerçant est vérifié et approuvé.
IN_REVIEW La modification du profil de marchand est en cours d'examen.
REJECTED La modification de la fiche du marchand est refusée.
INCOMPLETE_SIGNUP Le profil du marchand est incomplet.
SANCTIONS_HIT Le profil de marchand est soumis à des sanctions.
READY_FOR_REVIEW Le profil du commerçant est complet et prêt à être examiné.
DISABLED Le profil du marchand est désactivé/inactif.

Annotations d'outils

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients traitent ces indices comme non fiables, mais ils peuvent être utilisés pour déterminer quand un message de confirmation peut être envoyé à un utilisateur.

En plus de la chaîne de titre, les indications booléennes suivantes sont définies comme suit :

  • readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
  • destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", appeler l'outil à plusieurs reprises avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
  • openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Indication de destruction : ❌ | Indication d'idempotence : ✅ | Indication de lecture seule : ❌ | Indication de monde ouvert : ❌