MCP Tools Reference: paydeveloper.googleapis.com

Outil : create_merchant

Crée un marchand avec le compte authentifié. Vous DEVEZ demander à l'utilisateur de fournir les informations requises pour créer un marchand. Le code APE (activité principale exercée) est l'un des champs obligatoires. La liste des codes MCC étant longue, vous pouvez présenter un sous-ensemble d'options courantes, mais vous DEVEZ informer l'utilisateur que d'autres options sont disponibles et qu'il peut demander la liste complète (par exemple, en affichant "X autres options" ou une indication similaire). Indiquez également à l'utilisateur qu'il peut fournir directement le code CM à quatre chiffres (par exemple, 5499) s'il le connaît déjà, et encouragez-le à l'utiliser. N'appelez pas cet outil tant que vous n'avez pas essayé de collecter les informations requises pour la création du marchand. Une fois le marchand créé, vous DEVEZ présenter à l'utilisateur l'URL des conditions d'utilisation de la Business Console et lui demander de les accepter avant de pouvoir effectuer des opérations sur ce marchand.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP create_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": "create_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 CreateMerchant.

CreateMerchantRequest

Représentation JSON 
{
  "merchant": {
    object (Merchant)
  }
}
Champs
merchant

object (Merchant)

Obligatoire. Informations de base sur le marchand à créer.

Marchand

Représentation JSON 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Champs
merchantId

string

Uniquement en sortie. Identifiant unique du marchand.
displayName

string

Obligatoire. Nom à afficher du marchand.
regionCode

string

Obligatoire. Code de région de l'établissement du marchand. Le format correspond aux codes de région CLDR Unicode (par exemple, "US"). L'Inde ("IN") n'est pas acceptée.
mcc

enum (Mcc)

Obligatoire. Code de catégorie du marchand (MCC).
corporateWebsiteUrl

string

Obligatoire. Site Web de l'entreprise du marchand.
customerSupportWebsiteUrl

string

Obligatoire. Site Web du service client du marchand.
customerSupportEmail

string

Obligatoire. Adresse e-mail du service client du marchand.
customerSupportPhone

string

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

enum (State)

Uniquement en sortie. État 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 Animaleries, magasins d'aliments et d'accessoires pour animaux
OTHER_LODGING Autres hébergements : hôtels, motels, complexes touristiques
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 et de hasard en ligne) (région des États-Unis 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)

État

État d'un marchand.

Enums
STATE_UNSPECIFIED L'état du marchand n'est pas spécifié.
VERIFIED Le marchand est validé 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 marchand est complet et prêt à être examiné.
DISABLED Le profil du marchand est désactivé/inactif.

Schéma de sortie

Message de réponse pour CreateMerchant.

CreateMerchantResponse

Représentation JSON 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
Champs
merchantId

string

ID du marchand créé.
state

enum (State)

État du marchand créé.
businessConsoleTosUrl

string

Uniquement en sortie. URL des conditions d'utilisation de la Business Console. L'utilisateur doit accepter les conditions d'utilisation de la Business Console avant de pouvoir effectuer des opérations sur le marchand.

État

État d'un marchand.

Enums
STATE_UNSPECIFIED L'état du marchand n'est pas spécifié.
VERIFIED Le marchand est validé 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 marchand 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 destructive : ❌ | Indication d'idempotence : ❌ | Indication de lecture seule : ❌ | Indication de monde ouvert : ❌