mcp-payway

@codespar/mcp-payway

Payway（旧称 Prisma Medios de Pago／Decidir）向けの MCP サーバーです。アルゼンチンで広く利用されているカード決済ゲートウェイで、カードのトークン化、1 段階および 2 段階の決済、分割払い（cuotas）、マーケットプレイスの売上分配、返金に対応します。

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "payway": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-payway"],
      "env": {
        "PAYWAY_PUBLIC_API_KEY": "your-public-apikey",
        "PAYWAY_PRIVATE_API_KEY": "your-private-apikey",
        "PAYWAY_ENV": "sandbox"
      }
    }
  }
}

Claude Code

claude mcp add payway -- npx @codespar/mcp-payway

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します。

{
  "servers": {
    "payway": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-payway"],
      "env": {
        "PAYWAY_PUBLIC_API_KEY": "your-public-apikey",
        "PAYWAY_PRIVATE_API_KEY": "your-private-apikey",
        "PAYWAY_ENV": "sandbox"
      }
    }
  }
}

認証

Payway は、apikey という名前の単一の生ヘッダーで認証します（Authorization: Bearer ではありません）。同等の権限を持つキーが 2 種類あり、それぞれ使用できる操作が異なります。以下の表をご覧ください。

2 種類のキー

Payway は、使用できる操作が異なる同等の API キーを 2 種類発行します。

キー	ヘッダー	呼び出し可能な操作
公開	apikey	POST /tokens（カードのトークン化のみ）
秘密	apikey	その他すべて：決済、売上確定、返金、照会

認証ヘッダーは、apikey という名前の単一の生ヘッダーです。Authorization: Bearer ではありません。

ツール（6 種類）

ツール	エンドポイント	機能
create_token	POST /tokens	カード情報を 1 回限りの決済トークンにトークン化します（公開キー）
create_payment	POST /payments	トークンを使って決済します。分割払いにも対応した、単独決済または分配／分割決済です
get_payment	GET /payments/{id}	ID で決済を取得します
list_payments	GET /payments	決済を一覧表示します（offset、pageSize、siteOperationId、merchantId）
refund_payment	POST /payments/{id}/refunds	全額返金（空の本文）または一部返金（最小通貨単位で amount を指定）
confirm_payment	PUT /payments/{id}	事前承認済みの決済を売上確定します（2 段階のフロー）

環境変数

変数	必須	説明
PAYWAY_PUBLIC_API_KEY	はい	公開 apikey（トークン化）
PAYWAY_PRIVATE_API_KEY	はい	秘密 apikey（決済、返金、照会）
PAYWAY_ENV	いいえ	sandbox（デフォルト。Decidir のサンドボックスホスト）または production

ベース URL：本番環境 https://ventasonline.payway.com.ar/api/v2、サンドボックス https://developers.decidir.com/api/v2。

注意事項

• 金額は最小通貨単位の整数です。50000 は ARS 500.00 を表します。
• payment_method_id はカードブランドを識別します（1 = Visa、31 = Mastercard、15 = Maestro、…）。
• site_transaction_id は加盟店側の冪等性の基点であり、販売ごとに一意である必要があります。
• このサーバーがカード情報を生成することはありません。エージェントは PAN／有効期限／CVV をユーザーまたは保管庫から取得する必要があります。

エンタープライズ

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

ライセンス

MIT © CodeSpar