MCP Tools Reference: paydeveloper.googleapis.com

Alat: create_merchant

Membuat penjual baru dengan akun yang diautentikasi. Anda HARUS meminta pengguna untuk memberikan informasi yang diperlukan untuk pembuatan penjual. Salah satu kolom wajib diisi adalah Kode Kategori Penjual (MCC). Karena daftar MCC panjang, Anda dapat menampilkan sebagian opsi umum, tetapi Anda HARUS memberi tahu pengguna bahwa ada opsi lainnya dan mereka dapat meminta daftar lengkapnya (misalnya, dengan menampilkan "X opsi lainnya" atau petunjuk serupa). Selain itu, beri tahu pengguna bahwa mereka dapat langsung memberikan kode MCC 4 digit (misalnya, 5499) jika sudah mengetahuinya, dan dorong mereka untuk menggunakannya. Jangan gunakan alat ini sampai Anda mencoba mengumpulkan informasi yang diperlukan untuk pembuatan akun pedagang. Setelah penjual dibuat, Anda HARUS menampilkan URL Persyaratan Layanan Konsol Bisnis kepada pengguna dan menginstruksikan mereka untuk menyetujuinya sebelum mereka dapat melakukan operasi apa pun pada penjual ini.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP create_merchant.

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

Skema Input

Pesan permintaan untuk CreateMerchant.

CreateMerchantRequest

Representasi JSON 
{
  "merchant": {
    object (Merchant)
  }
}
Kolom
merchant

object (Merchant)

Wajib. Informasi dasar penjual yang akan dibuat.

Penjual

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

string

Hanya output. ID unik penjual.
displayName

string

Wajib. Nama tampilan pedagang.
regionCode

string

Wajib. Kode wilayah lokasi bisnis penjual. Formatnya adalah kode wilayah CLDR Unicode, misalnya, "US". India ("IN") tidak didukung.
mcc

enum (Mcc)

Wajib. Kode Kategori Penjual (MCC) penjual.
corporateWebsiteUrl

string

Wajib. Situs perusahaan penjual.
customerSupportWebsiteUrl

string

Wajib. Situs dukungan pelanggan penjual.
customerSupportEmail

string

Wajib. Email dukungan pelanggan penjual.
customerSupportPhone

string

Wajib. Nomor telepon dukungan pelanggan penjual.
state

enum (State)

Hanya output. Status penjual.

Mcc

Kode Kategori Penjual (MCC) penjual.

Enum
OTHERS Lainnya
MISC_FOOD_STORES Toko Makanan Lainnya – Minimarket dan Pasar Khusus
MISC_APPAREL Toko Pakaian dan Aksesori Lainnya
ARTISTS_SUPPLY Toko Perlengkapan Seni dan Kerajinan
AUTOMOTIVE_PARTS Toko Suku Cadang, Aksesori Otomotif
HEALTH_AND_BEAUTY Toko Kesehatan dan Kecantikan
BOOKS_PERIODICALS Buku, Majalah, dan Koran
CAMERA_STORES Toko Peralatan Fotografi dan Kamera
COMPUTERS_EQUIPMENT Komputer, Peralatan Periferal Komputer, Software
COMPUTER_SOFTWARE Toko Software Komputer
ELECTRONICS_SALES Penjualan Elektronik
GIFT_SHOPS Toko Kartu, Toko Hadiah, Toko Barang Unik, dan Toko Suvenir
EATING_PLACES Tempat Makan dan Restoran
MISC_GENERAL_MERCHANDISE Barang Dagangan Umum Lainnya
HOME_SUPPLY Toko Gudang Perlengkapan Rumah
COMPUTER_NETWORK_SERVICES Layanan Jaringan Komputer
DIGITAL_GOODS_MEDIA Produk Digital: Buku, Film, Musik
DIGITAL_GOODS_GAMES Produk Digital: Game
DIGITAL_GOODS_APPLICATIONS Barang Digital: Aplikasi (Tidak Termasuk Game)
POLITICAL_ORGANIZATIONS Organisasi Politik
CHARITABLE_ORGANIZATIONS Organisasi Amal dan Layanan Sosial
DRUG_STORES Toko Obat dan Apotek
REAL_ESTATE_RENTALS Agen dan Pengelola Properti - Penyewaan
MISC_PERSONAL_SERVICES Layanan Pribadi Lainnya, Tidak Diklasifikasikan di Tempat Lain
SPORTING_GOODS Toko Peralatan Olahraga
STATIONERY_OFFICE_SUPPLIES Alat Tulis, Perlengkapan Kantor, Kertas Cetak dan Kertas Tulis
THEATRICAL_TICKET_AGENCIES Agen Tiket Teater
TIMESHARES Timeshare
TOURIST_ATTRACTIONS Objek Wisata dan Pameran
HOBBY_TOY_GAME_SHOPS Toko Hobi, Mainan, dan Permainan
PET_SHOPS Toko Hewan Peliharaan, Toko Makanan dan Perlengkapan Hewan Peliharaan
OTHER_LODGING Penginapan Lainnya–Hotel, Motel, Resor
TELECOMMUNICATION_SERVICES Layanan Telekomunikasi
TRANSPORTATION_SERVICES Layanan Transportasi
OTHER_AIRLINES Maskapai Penerbangan Lainnya
TRAVEL_AGENCIES Agen Perjalanan dan Operator Tur
GOVERNMENT_OWNED_LOTTERIES_US Lotre yang Dimiliki Pemerintah (Khusus Wilayah AS)
GOVERNMENT_LICENSED_CASINOS_US Kasino Online Berlisensi Pemerintah (Perjudian Online) (Khusus Wilayah Amerika Serikat)
BETTING Taruhan (termasuk Tiket Lotre, Chip Game Kasino, Taruhan di Luar Arena Pacuan Kuda, dan Taruhan)
GOVERNMENT_OWNED_LOTTERIES_NON_US Lotre yang Dimiliki Pemerintah (Wilayah non-Amerika Serikat)

Negara bagian/Provinsi

Status penjual.

Enum
STATE_UNSPECIFIED Status penjual tidak ditentukan.
VERIFIED Penjual telah diverifikasi dan disetujui.
IN_REVIEW Hasil edit profil penjual sedang dalam peninjauan.
REJECTED Pengeditan profil penjual ditolak.
INCOMPLETE_SIGNUP Profil penjual belum lengkap.
SANCTIONS_HIT Profil penjual terkena sanksi.
READY_FOR_REVIEW Profil penjual sudah lengkap dan siap ditinjau.
DISABLED Profil penjual dinonaktifkan/tidak aktif.

Skema Output

Pesan respons untuk CreateMerchant.

CreateMerchantResponse

Representasi JSON 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
Kolom
merchantId

string

ID penjual dari penjual yang dibuat.
state

enum (State)

Status penjual yang dibuat.
businessConsoleTosUrl

string

Hanya output. URL Persyaratan Layanan Konsol Bisnis. Pengguna harus menyetujui Persyaratan Layanan Konsol Bisnis sebelum dapat melakukan operasi apa pun pada penjual.

Negara bagian/Provinsi

Status penjual.

Enum
STATE_UNSPECIFIED Status penjual tidak ditentukan.
VERIFIED Penjual telah diverifikasi dan disetujui.
IN_REVIEW Hasil edit profil penjual sedang dalam peninjauan.
REJECTED Pengeditan profil penjual ditolak.
INCOMPLETE_SIGNUP Profil penjual belum lengkap.
SANCTIONS_HIT Profil penjual terkena sanksi.
READY_FOR_REVIEW Profil penjual sudah lengkap dan siap ditinjau.
DISABLED Profil penjual dinonaktifkan/tidak aktif.

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk ini dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim ke pengguna.

Selain string judul, petunjuk boolean berikut ditentukan sebagai berikut:

  • readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
  • destructiveHint: Jika benar (true), alat dapat melakukan tindakan merusak. Jika salah (false), alat hanya dapat melakukan tindakan tambahan. Default: true.
  • idempotentHint: Jika benar (true), memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
  • openWorldHint: Jika benar, alat dapat berinteraksi dengan 'dunia terbuka' entitas eksternal. Jika salah (false), alat hanya dapat berinteraksi dengan entitas internal. Misalnya, alat penelusuran web akan menjadi open world, sedangkan alat memori tidak akan menjadi open world.

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ❌