mcp-izipay

@codespar/mcp-izipay

Izipay 向け MCP サーバー — ペルーの法人向けアクワイアラーです。

Izipay は、Niubiz（Visa とペルーの銀行による合弁会社）の加盟店向けブランドであり、ペルー最大のカードアクワイアラーです。シェアは 20% 以上です。Niubiz/Izipay は、取扱高が大きく、アクワイアラーと直接契約を結ぶ法人加盟店にとって標準的な選択肢です。

Culqi との位置付け

	@codespar/mcp-culqi	@codespar/mcp-izipay
セグメント	ペルーの中小企業	ペルーの法人
種類	PSP（Stripe 相当）	アクワイアラー（Niubiz）
利用開始	セルフサービス	商業契約
顧客	D2C、SaaS、スタートアップ	小売チェーン、航空会社、公益事業者、銀行

取扱高の大きいペルーの加盟店は通常、PSP を導入する前に Izipay とアクワイアラー契約を結んでいます。顧客、契約、商業条件が異なるため、2 つのサーバーは互いを補完します。

ステータス：アルファ

これは 0.1.0-alpha.1 です。Izipay の開発者ポータル developers.izipay.pe は契約者限定です。公開ホームページでは API が紹介されていますが、完全な REST リファレンスを利用できるのは契約済みの加盟店のみです。このサーバーのエンドポイントパスは、Izipay の公開 SDK リポジトリ（github.com/izipay-pe）と一般的な Niubiz/Izipay の REST 慣例から、最善を尽くして推測したものです。以下のすべてのエンドポイントは、本番稼働前にお使いのインテグレーションキットで検証してください。修正は PR で歓迎します。

推定エンドポイント（未検証）

ツール	メソッド	パス
認証（内部）	POST	/auth/login
create_charge	POST	/v1/charges
capture_charge	POST	/v1/charges/{id}/capture
cancel_charge	POST	/v1/charges/{id}/cancel
refund_charge	POST	/v1/charges/{id}/refund
get_charge	GET	/v1/charges/{id}
tokenize_card	POST	/v1/tokens
delete_token	DELETE	/v1/tokens/{id}
create_installment_plan	POST	/v1/installments
list_transactions	GET	/v1/transactions
get_settlement	GET	/v1/settlements/{date}

ツール（20）

ツール	用途
create_charge	カード決済を承認します。
capture_charge	以前に承認された請求をキャプチャします（create_charge で capture=false を指定した場合）。
cancel_charge	承認済みで未キャプチャの請求を無効にします。
refund_charge	キャプチャ済みの請求を返金します。
get_charge	Izipay の請求 ID で請求を取得します。
tokenize_card	PCI に準拠した安全な再利用のためにカードをトークン化します。
delete_token	保存済みのカードトークンを削除します。
create_installment_plan	請求にペルーの cuotas（分割払い）プランを作成します。
list_transactions	照合用に取引を一覧表示します。
get_settlement	指定日の決済バッチ（liquidación）を取得します。
get_charge_by_order	加盟店側の orderNumber（create_charge に渡した order_id）で請求を取得します。
list_installment_options	指定したカード BIN と金額で利用可能な cuota プログラムを照会します。
list_settlements	期間を指定して決済バッチを一覧表示します。
create_payment_link	ホスト型の決済リンク（リンク決済）を作成します。
get_payment_link	ID で決済リンクを取得します。
pay_yape	Yape による直接決済を開始します。
pay_plin	Plin による直接決済を開始します。
authenticate_3ds	3-D Secure のチャレンジを完了します。
create_subscription	カードの継続課金（サブスクリプション）を開始します。
cancel_subscription	有効なサブスクリプションをキャンセルします。

インストール

npm install @codespar/mcp-izipay@alpha

環境

IZIPAY_USERNAME="..."       # merchant username
IZIPAY_PASSWORD="..."       # merchant password (secret)
IZIPAY_MERCHANT_CODE="..."  # codigoComercio
IZIPAY_ENV="production"     # or "sandbox"
IZIPAY_BASE_URL="..."       # Optional override

デフォルト：

• IZIPAY_ENV=production → https://api.izipay.pe
• IZIPAY_ENV=sandbox → https://sandbox-api.izipay.pe

認証

JWT Bearer です。最初の API 呼び出し時に、サーバーは { username, password, merchantCode } を /auth/login に POST し、返された JWT をメモリ内にキャッシュします。その後のすべてのリクエストには Authorization: Bearer <jwt> として JWT を付加します。キャッシュされた JWT は有効期限の 60 秒前に更新されます。呼び出し側での対応は不要です。

実行

# stdio (default)
npx @codespar/mcp-izipay

# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-izipay

エンタープライズ

エージェントの決済にガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT