MCP Tools Reference: paydeveloper.googleapis.com

ツール: create_merchant

認証されたアカウントで新しい販売者を作成します。販売者登録に必要な情報をユーザーに提供してもらうよう、必ず依頼してください。必須項目の 1 つは販売者カテゴリコード（MCC）です。MCC のリストは長いため、一般的なオプションのサブセットを表示しても構いませんが、より多くのオプションが利用可能であり、完全なリストをリクエストできることをユーザーに必ず知らせる必要があります（「X 個のオプションがさらにあります」などのヒントを表示するなど）。また、4 桁の MCC コード（5499 など）をすでに知っている場合は、直接入力できることをお客様に伝え、そのコードを使用するよう促します。販売者作成に必要な情報を収集するまで、このツールを呼び出さないでください。加盟店が作成された後、ユーザーがこの加盟店に対して何らかの操作を行う前に、必ず Business Console の利用規約の URL をユーザーに提示し、同意するよう指示する必要があります。

次のコードサンプルは、curl を使用して create_merchant MCP ツールを呼び出す方法を示しています。

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

入力スキーマ

CreateMerchant に対するリクエスト メッセージ。

CreateMerchantRequest

JSON 表現 
{
  "merchant": {
    object (Merchant)
  }
}
フィールド
merchant

object (Merchant)

必須。作成する販売者の基本情報。

販売者

JSON 表現 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
フィールド
merchantId

string

出力専用。販売者の一意の識別子。
displayName

string

必須。販売者の表示名。
regionCode

string

必須。加盟店の店舗拠点を示す地域コード。フォーマットは Unicode CLDR 地域コードです。例：「US」。インド（「IN」）はサポートされていません。
mcc

enum (Mcc)

必須。販売者の販売者カテゴリコード（MCC）。
corporateWebsiteUrl

string

必須。販売業者の企業ウェブサイト。
customerSupportWebsiteUrl

string

必須。販売者のカスタマー サポートのウェブサイト。
customerSupportEmail

string

必須。販売者のカスタマー サポートのメールアドレス。
customerSupportPhone

string

必須。販売店のカスタマーサポート電話番号。
state

enum (State)

出力専用。販売者の状態。

Mcc

販売者の販売者カテゴリコード（MCC）。

列挙型
OTHERS その他
MISC_FOOD_STORES その他の食料品店 – コンビニエンスストアおよび専門店
MISC_APPAREL その他の衣料品店、アクセサリー店
ARTISTS_SUPPLY 画材店とクラフトショップ
AUTOMOTIVE_PARTS 自動車部品、アクセサリーの販売店
HEALTH_AND_BEAUTY 健康美容製品販売店
BOOKS_PERIODICALS 書籍、定期刊行物、新聞
CAMERA_STORES カメラ、写真用品店
COMPUTERS_EQUIPMENT コンピュータ、コンピュータ周辺機器、ソフトウェア
COMPUTER_SOFTWARE コンピュータ ソフトウェア ストア
ELECTRONICS_SALES 電化製品の販売
GIFT_SHOPS カードショップ、ギフトショップ、ノベルティ ショップ、土産物店
EATING_PLACES 飲食できる場所、レストラン
MISC_GENERAL_MERCHANDISE その他の雑貨、日用品
HOME_SUPPLY ホーム用品の倉庫店
COMPUTER_NETWORK_SERVICES コンピュータ ネットワーク サービス
DIGITAL_GOODS_MEDIA デジタル商品: 書籍、映画、音楽
DIGITAL_GOODS_GAMES デジタル商品: ゲーム
DIGITAL_GOODS_APPLICATIONS デジタル商品: アプリケーション（ゲームを除く）
POLITICAL_ORGANIZATIONS 政治団体
CHARITABLE_ORGANIZATIONS 慈善団体、社会福祉団体
DRUG_STORES ドラッグストアと薬局
REAL_ESTATE_RENTALS 不動産業者と不動産経営 - 賃貸
MISC_PERSONAL_SERVICES その他の個人サービス（他に分類されているもの以外）
SPORTING_GOODS スポーツ用品店
STATIONERY_OFFICE_SUPPLIES 文房具、事務用品、印刷用紙、筆記用紙
THEATRICAL_TICKET_AGENCIES 劇場チケット販売業者
TIMESHARES タイムシェア
TOURIST_ATTRACTIONS 観光名所と展示
HOBBY_TOY_GAME_SHOPS ホビー、おもちゃ、ゲームショップ
PET_SHOPS ペットショップ、ペットフード、ペット用品店
OTHER_LODGING その他の宿泊施設 - ホテル、モーテル、リゾート
TELECOMMUNICATION_SERVICES 通信サービス
TRANSPORTATION_SERVICES Transportation Services
OTHER_AIRLINES その他の航空会社
TRAVEL_AGENCIES 旅行代理店、ツアー オペレーター
GOVERNMENT_OWNED_LOTTERIES_US 政府所有の宝くじ（米国リージョンのみ）
GOVERNMENT_LICENSED_CASINOS_US 政府認可のオンライン カジノ（オンライン ギャンブル）（米国のみ）
BETTING 賭博（宝くじ、カジノゲームのチップ、場外賭博、賭けを含む）
GOVERNMENT_OWNED_LOTTERIES_NON_US 政府所有の宝くじ（米国以外の地域）

州

販売者の状態。

列挙型
STATE_UNSPECIFIED 販売者の状態は指定されていません。
VERIFIED 販売者の確認と承認が完了している。
IN_REVIEW 販売者プロフィールの編集内容は審査中です。
REJECTED 販売者プロフィールの編集が拒否されます。
INCOMPLETE_SIGNUP 販売者プロフィールが不完全です。
SANCTIONS_HIT 販売者プロフィールが制裁措置に該当している。
READY_FOR_REVIEW 販売者プロフィールが完成し、審査の準備が整いました。
DISABLED 販売者プロフィールが無効または非アクティブです。

出力スキーマ

CreateMerchant に対するレスポンス メッセージ。

CreateMerchantResponse

JSON 表現 
{
  "merchantId": string,
  "state": enum (State),
  "businessConsoleTosUrl": string
}
フィールド
merchantId

string

作成された販売者の販売者 ID。
state

enum (State)

作成された販売者の状態。
businessConsoleTosUrl

string

出力専用。Business Console 利用規約の URL。ユーザーは、加盟店に対して何らかの操作を行う前に、Business Console の利用規約に同意する必要があります。

州

販売者の状態。

列挙型
STATE_UNSPECIFIED 販売者の状態は指定されていません。
VERIFIED 販売者の確認と承認が完了している。
IN_REVIEW 販売者プロフィールの編集内容は審査中です。
REJECTED 販売者プロフィールの編集が拒否されます。
INCOMPLETE_SIGNUP 販売者プロフィールが不完全です。
SANCTIONS_HIT 販売者プロフィールが制裁措置に該当している。
READY_FOR_REVIEW 販売者プロフィールが完成し、審査の準備が整いました。
DISABLED 販売者プロフィールが無効または非アクティブです。

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントはこれらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを決定するために使用できます。

タイトル文字列とともに、次のブール値のヒントが次のように定義されています。

  • readOnlyHint: true の場合、ツールは環境を変更しません。デフォルトは false です。
  • destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
  • idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に影響はありません。デフォルトは false です。
  • openWorldHint: true の場合、ツールは外部エンティティの「オープン ワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ❌ | 読み取り専用ヒント: ❌ | オープン ワールド ヒント: ❌