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. 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 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 tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Schéma d'entrée
Message de requête pour CreateMerchant.
CreateMerchantRequest
| Représentation JSON |
|---|
{
"merchant": {
object ( |
| Champs | |
|---|---|
merchant |
Obligatoire. Informations de base sur le marchand à créer. |
Marchand
| Représentation JSON |
|---|
{ "merchantId": string, "displayName": string, "regionCode": string, "mcc": enum ( |
| Champs | |
|---|---|
merchantId |
Uniquement en sortie. Identifiant unique du marchand. |
displayName |
Obligatoire. Nom à afficher du marchand. |
regionCode |
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 |
Obligatoire. Code de catégorie du marchand (MCC). |
corporateWebsiteUrl |
Obligatoire. Site Web de l'entreprise du marchand. |
customerSupportWebsiteUrl |
Obligatoire. Site Web du service client du marchand. |
customerSupportEmail |
Obligatoire. Adresse e-mail du service client du marchand. |
customerSupportPhone |
Obligatoire. Numéro de téléphone du service client du marchand. |
state |
Uniquement en sortie. État du marchand. |
Mcc
Code de catégorie du marchand (MCC).
| 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 |
Produits 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 hôteliers |
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 au gouvernement (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 piste et les mises) |
GOVERNMENT_OWNED_LOTTERIES_NON_US |
Loteries appartenant à des organismes publics (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 ( |
| Champs | |
|---|---|
merchantId |
ID du marchand créé. |
state |
État du marchand créé. |
businessConsoleTosUrl |
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
Indication de destruction : ❌ | Indication d'idempotence : ❌ | Indication de lecture seule : ❌ | Indication de monde ouvert : ❌