MCP Tools Reference: paydeveloper.googleapis.com

Araç: create_merchant

Kimliği doğrulanmış hesapla yeni bir satıcı oluşturur. Kullanıcıdan satıcı oluşturma için gerekli bilgileri sağlamasını İSTEMELİSİNİZ. Zorunlu alanlardan biri satıcı kategorisi kodudur (MCC). MCC listesi uzun olduğundan, yaygın seçeneklerin bir alt kümesini sunabilirsiniz ancak kullanıcıya daha fazla seçeneğin mevcut olduğunu ve tam listeyi isteyebileceğini BİLDİRMENİZ GEREKİR (ör. "X daha fazla seçenek" veya benzer bir ipucu göstererek). Ayrıca, kullanıcıyı 4 haneli MM kodunu (ör. 5499) biliyorsa doğrudan sağlayabileceği konusunda bilgilendirin ve bu kodu kullanmaya teşvik edin. Satıcı oluşturma için gerekli bilgileri toplamayı denemeden bu aracı çağırmayın. Satıcı oluşturulduktan sonra, kullanıcının bu satıcıyla ilgili herhangi bir işlem yapabilmesi için ÖNCELİKLE İşletme Konsolu Hizmet Şartları URL'sini göstermeniz ve kullanıcının bu URL'yi kabul etmesini sağlamanız GEREKİR.

Aşağıdaki kod örneğinde, create_merchant MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş Şeması

CreateMerchant için istek mesajı.

CreateMerchantRequest

JSON gösterimi 
{
  "merchant": {
    object (Merchant)
  }
}
Alanlar
merchant

object (Merchant)

Zorunlu. Oluşturulacak satıcının temel bilgileri

Satıcı

JSON gösterimi 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Alanlar
merchantId

string

Yalnızca çıkış. Satıcının benzersiz tanımlayıcısı.
displayName

string

Zorunlu. Satıcının görünen adı.
regionCode

string

Zorunlu. Satıcının işletmesinin bulunduğu konumun bölge kodu. Biçim, Unicode CLDR bölge kodlarıdır (ör. "US"). Hindistan ("IN") desteklenmez.
mcc

enum (Mcc)

Zorunlu. Satıcının Satıcı Kategori Kodu (MCC).
corporateWebsiteUrl

string

Zorunlu. Satıcının kurumsal web sitesi.
customerSupportWebsiteUrl

string

Zorunlu. Satıcının müşteri desteği web sitesi.
customerSupportEmail

string

Zorunlu. Satıcının müşteri desteği e-posta adresi.
customerSupportPhone

string

Zorunlu. Satıcının müşteri destek telefon numarası.
state

enum (State)

Yalnızca çıkış. Satıcının bulunduğu eyalet.

Mcc

Satıcının satıcı kategorisi kodu (MCC).

Sıralamalar
OTHERS Diğer
MISC_FOOD_STORES Çeşitli Gıda Mağazaları – Marketler ve Özel Marketler
MISC_APPAREL Çeşitli Giyim ve Aksesuar Mağazaları
ARTISTS_SUPPLY Sanatçı Malzemeleri ve El Sanatları Mağazaları
AUTOMOTIVE_PARTS Otomotiv Parçaları, Aksesuar Mağazaları
HEALTH_AND_BEAUTY Sağlık ve Güzellik Merkezi
BOOKS_PERIODICALS Kitaplar, Süreli Yayınlar ve Gazeteler
CAMERA_STORES Kamera ve Fotoğraf Malzemeleri Mağazaları
COMPUTERS_EQUIPMENT Bilgisayarlar, Bilgisayar Çevre Birimleri, Yazılımlar
COMPUTER_SOFTWARE Bilgisayar Yazılımı Mağazaları
ELECTRONICS_SALES Elektronik Satışları
GIFT_SHOPS Kart mağazaları, hediye, yenilik ve hediyelik eşya mağazaları
EATING_PLACES Yemek Yenebilecek Yerler ve Restoranlar
MISC_GENERAL_MERCHANDISE Muhtelif Genel Ürünler
HOME_SUPPLY Ev malzemeleri toptan satış mağazaları
COMPUTER_NETWORK_SERVICES Bilgisayar Ağı Hizmetleri
DIGITAL_GOODS_MEDIA Dijital Ürünler: Kitaplar, Filmler, Müzik
DIGITAL_GOODS_GAMES Dijital Ürünler: Oyunlar
DIGITAL_GOODS_APPLICATIONS Dijital Ürünler: Uygulamalar (Oyunlar Hariç)
POLITICAL_ORGANIZATIONS Siyasi kuruluşlar
CHARITABLE_ORGANIZATIONS Hayır ve Sosyal Hizmet Kuruluşları
DRUG_STORES Eczaneler
REAL_ESTATE_RENTALS Emlakçı ve Yönetici - Kiralama
MISC_PERSONAL_SERVICES Diğer Kişisel Hizmetler, Başka Yerde Sınıflandırılmamış
SPORTING_GOODS Spor Ürünleri Mağazaları
STATIONERY_OFFICE_SUPPLIES Kırtasiye, Ofis Malzemeleri, Baskı ve Yazı Kağıdı
THEATRICAL_TICKET_AGENCIES Tiyatro Bilet Acenteleri
TIMESHARES Devre Mülkler
TOURIST_ATTRACTIONS Turistik Yerler ve Sergiler
HOBBY_TOY_GAME_SHOPS Hobi, Oyuncak ve Oyun Mağazaları
PET_SHOPS Evcil hayvan mağazaları, evcil hayvan mamaları ve bakım ürünleri mağazaları
OTHER_LODGING Diğer Konaklama Yerleri (Oteller, Moteller, Tatil Köyleri)
TELECOMMUNICATION_SERVICES Telekomünikasyon Hizmetleri
TRANSPORTATION_SERVICES Ulaşım Hizmetleri
OTHER_AIRLINES Diğer hava yolları
TRAVEL_AGENCIES Seyahat Acenteleri ve Tur Operatörleri
GOVERNMENT_OWNED_LOTTERIES_US Devlete Ait Piyangolar (yalnızca ABD bölgesi)
GOVERNMENT_LICENSED_CASINOS_US Resmi lisanslı online kumarhaneler (online kumar) (yalnızca ABD bölgesi)
BETTING Bahis (piyango biletleri, kumarhane oyun çipleri, hipodrom dışı bahisler ve iddialar dahil)
GOVERNMENT_OWNED_LOTTERIES_NON_US Devlete ait piyangolar (ABD dışındaki bölgeler)

Eyalet

Satıcının durumu.

Sıralamalar
STATE_UNSPECIFIED Satıcının bulunduğu eyalet belirtilmemiş.
VERIFIED Satıcı doğrulandı ve onaylandı.
IN_REVIEW Satıcı profili düzenlemesi inceleniyor.
REJECTED Satıcı profili düzenlemesi reddedilir.
INCOMPLETE_SIGNUP Satıcı profili tamamlanmamış.
SANCTIONS_HIT Satıcı profili yaptırımlara tabi.
READY_FOR_REVIEW Satıcı profili tamamlandı ve incelenmeye hazır.
DISABLED Satıcı profili devre dışı/etkin değil.

Çıkış şeması

CreateMerchant için yanıt mesajı.

CreateMerchantResponse

JSON gösterimi 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
Alanlar
merchantId

string

Oluşturulan satıcının satıcı kimliği.
state

enum (State)

Oluşturulan satıcının durumu.
businessConsoleTosUrl

string

Yalnızca çıkış. İşletme Konsolu Hizmet Şartları URL'si. Kullanıcının satıcı üzerinde herhangi bir işlem yapabilmesi için İşletme Konsolu Hizmet Şartları'nı kabul etmesi gerekir.

Eyalet

Satıcının durumu.

Sıralamalar
STATE_UNSPECIFIED Satıcının bulunduğu eyalet belirtilmemiş.
VERIFIED Satıcı doğrulandı ve onaylandı.
IN_REVIEW Satıcı profili düzenlemesi inceleniyor.
REJECTED Satıcı profili düzenlemesi reddedilir.
INCOMPLETE_SIGNUP Satıcı profili tamamlanmamış.
SANCTIONS_HIT Satıcı profili yaptırımlara tabi.
READY_FOR_REVIEW Satıcı profili tamamlandı ve incelenmeye hazır.
DISABLED Satıcı profili devre dışı/etkin değil.

Araç Ek Açıklamaları

Araç açıklamaları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilmeyen olarak değerlendirir ancak onay isteminin kullanıcıya ne zaman gönderileceğine karar vermek için kullanılabilirler.

Başlık dizesinin yanı sıra aşağıdaki Boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğruysa araç, ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğruysa araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
  • idempotentHint: Doğruysa aynı bağımsız değişkenlerle aracı tekrar tekrar çağırmanın ortamı üzerinde ek bir etkisi olmaz. Varsayılan: false.
  • openWorldHint: Doğruysa araç, harici öğelerden oluşan bir "açık dünya" ile etkileşim kurabilir. Yanlışsa araç yalnızca dahili öğelerle etkileşim kurabilir. Örneğin, bir web arama aracı açık dünya olurken bir bellek aracı açık dünya olmaz.

Yok Edici İpucu: ❌ | İdempotent İpucu: ❌ | Salt Okunur İpucu: ❌ | Açık Dünya İpucu: ❌