HitPay MCP Server

Claude Code 向け HitPay プラグイン

Claude Code 向けの、設定不要な東南アジアの決済連携です。HitPay の決済ゲートウェイに関する深い知識と、API へのライブアクセスを Claude に提供します。これにより、開発者が決済連携について尋ねると、適切な決済方法、Webhook 処理、チェックアウトフローを備えた本番環境対応のコードを Claude が生成します。

内容

レイヤー	機能	ファイル
MCP Server	API へのライブアクセス — 決済の作成、ステータスの確認、アカウントの照会	.mcp.json
Skills	HitPay 連携に適したコードパターンを Claude に教えます	skills/（5 つのスキル）
Commands	開発者向けアクション — ひな形の生成、照会、テスト、QR チェックアウト	commands/（4 つのコマンド）

インストール

マーケットプレイス経由（推奨）

/plugin marketplace add hit-pay/claude-code-plugin
/plugin install hitpay@hitpay-plugins

ローカル開発

git clone https://github.com/hit-pay/claude-code-plugin.git hitpay-plugin
claude --plugin-dir ./hitpay-plugin

セットアップ

HitPay API の認証情報を設定します。

export HITPAY_API_KEY=your_api_key_here
export HITPAY_SALT=your_webhook_salt_here

認証情報は、HitPay Dashboard の「Settings > Payment Gateway > API Keys」から取得してください。

スキル

Claude が会話中の関連するコンテキストを検出すると、スキルが自動的に呼び出されます。

スキル	呼び出しのきっかけ	教える内容
payment-integration	「HitPay を追加」「決済チェックアウト」「決済を受け付ける」	API ルート、リダイレクト／QR／セレクターフロー、認証ヘッダー、テストカード
webhook-handler	「Webhook 署名」「決済通知」「Webhook を検証」	HMAC-SHA256 検証、イベントタイプ、IP 許可リスト、冪等性
payment-methods	「マレーシアの決済方法」「決済方法はどれ」「対応している決済方法」	国別の決済方法対応表、API 値、通貨、利用不可の決済方法
drop-in-ui	「決済フォームを埋め込む」「HitPay.js」「チェックアウトポップアップ」	HitPay.js スクリプト、初期化オプション、Next.js 連携、イベント処理
qr-checkout	「QR チェックアウトページ」「QR 決済ページ」「PayNow 用の QR コードを表示」	事前レンダリングされた QR 画像、ローカル HTML ページ、オフライン対応、CDN 不要

コマンド

コマンド	説明	例
/hitpay:init	連携一式のひな形を生成します	/hitpay:init nextjs sg,my
/hitpay:methods	国別の決済方法を調べます	/hitpay:methods ph
/hitpay:webhook-test	Webhook テスト用ペイロードと curl を生成します	/hitpay:webhook-test charge.created
/hitpay:qr-checkout	スキャン可能なコード付きの QR 決済ページを生成します	/hitpay:qr-checkout 100 sgd paynow,qris

MCP ツール

HITPAY_API_KEY が設定されている場合、Claude は開発中に以下のツールを使用できます。

読み取り操作

• get_account_status — KYC と有効なプロバイダーを確認します
• get_balances — 現在のアカウント残高
• get_payment_request — 決済リクエストの詳細
• list_payment_requests — 決済リクエストの一覧
• list_charges — 絞り込み条件を指定して請求の一覧を取得します
• get_charge_detail — 請求の詳細
• list_customers — 顧客の一覧
• get_customer — 顧客の詳細
• list_invoices — 請求書の一覧
• list_subscription_plans — サブスクリプションプランの一覧
• list_static_qrs — 静的 QR コードの一覧
• get_supported_qr_methods — 利用可能な QR 決済方法
• get_account_info — アカウントの概要

作成操作

• create_payment_request — チェックアウト URL 付きの決済を作成します
• create_customer — 顧客レコードを作成します
• create_invoice — 請求書を作成します
• create_embedded_qr — 決済受け付け用の QR を生成します
• create_static_qr — 永続的な QR（POS）を作成します
• create_webhook_event — Webhook URL を登録します
• create_recurring_billing — サブスクリプションを設定します

対応市場

市場	通貨	主な決済方法
シンガポール	SGD	PayNow、GrabPay、ShopeePay、カード
マレーシア	MYR	GrabPay、ShopeePay、Touch 'n Go、FPX
フィリピン	PHP	QR Ph、GCash、ShopeePay
タイ	THB	PromptPay、TrueMoney
ベトナム	VND	VietQR、ZaloPay
インドネシア	IDR	QRIS
インド	INR→SGD	UPI
オーストラリア	AUD	PayTo
クロスボーダー	自動 FX	9 種類のボーダーレス QR 決済方法

セキュリティ

このプラグインは、安全性をデフォルトとする方針に従っています。

• 含まれる操作：読み取り操作と決済の作成（取り消し可能／安全）
• スキルから除外：返金、削除、送金、キャンセル（破壊的／金銭に関わる操作）
• Webhook の検証：生成されるすべての Webhook ハンドラーに HMAC-SHA256 署名チェックが含まれます
• API キー：生成されたコードでクライアント側に公開されることはありません

ライセンス

MIT