Skip to main content
Glama

💳 unified-pay-cli

Stripe、Razorpay、LemonSqueezy対応のユニバーサル決済ゲートウェイCLI & Model Context Protocol (MCP) サーバー

npm version License: MIT MCP Protocol PRs Welcome


🚀 ハイライト

  • インストール不要: npx unified-pay-cli で即座にオンデマンド実行可能。

  • 🎯 マルチプロバイダーエンジン: StripeRazorpayLemonSqueezy 間で統一されたインターフェース。

  • 🛠️ スマート決済リンク生成: 対話型ターミナルUIプロンプト、または直接スクリプト化されたCLIフラグ。

  • 🔄 完全な取引・返金ライフサイクル: ライブステータス確認、最近の取引一覧、部分/全額返金、専用の返金進捗追跡。

  • 📡 Webhookステーション & 転送プロキシ: 組み込みHTTPリスナー(pay listen)がWebhookイベントを傍受し、色分け表示し、ローカルバックエンドに直接転送(--forward http://localhost:3000/api/webhooks)。

  • 🔒 暗号署名検証: 組み込みHMAC-SHA256検証(--secret)により、改ざんされたWebhookペイロードからローカル開発を保護。

  • 🤖 ネイティブModel Context Protocol (MCP): 決済スタックをGitHub Copilot、Cursor、Claude Desktopに接続し、AIが自然言語プロンプトからリンク作成、署名検証、請求書追跡を実行可能。


Related MCP server: mcp-dev-brasil

⚡ クイックスタート

1. インストール

グローバルインストール、または npx 経由でオンデマンド実行:

# Global install (recommended for daily CLI use)
npm install -g unified-pay-cli

# Or run instantly with npx
npx unified-pay-cli --help

2. 認証情報の設定

# Stripe
pay config --stripe-key sk_test_51...

# Razorpay
pay config --razorpay-id rzp_test_... --razorpay-secret ...

# LemonSqueezy (Optional)
pay config --lemonsqueezy-key lms_... --lemonsqueezy-store 12345

💻 CLIコマンドリファレンス

1. 決済リンクの作成(pay link

# Interactive mode (prompts for provider, amount, description)
pay link

# Scriptable flag mode
pay link --provider razorpay --amount 350000 --currency INR --desc "2-Hour Technical Consultation"
pay link --provider stripe --amount 2500 --currency USD --desc "Pro Tier Subscription"

2. 取引の照会(pay txn

# List recent transactions
pay txn list --provider razorpay --limit 5

# Check specific payment details
pay txn status pay_Oq7Jk8LmNx9 --provider razorpay

3. 返金の発行・追跡(pay refund

pay は、チャージと返金エンティティの個別のライフサイクルを処理します:

# Issue a refund (full or partial in minor units)
pay refund create pay_Oq7Jk8LmNx9 --provider razorpay --amount 10000

# Track live refund progression
pay refund status rfnd_TRNTRFvhQ6NDKx --provider razorpay

# List all past refunds
pay refund list --provider razorpay

4. Webhookステーション、検証、プロキシ(pay listen

複雑なトンネリング設定なしで、ローカル開発中にリアルタイムのWebhookイベントをキャッチ:

# 1. Basic listener
pay listen --port 4242

# 2. Listener with HMAC-SHA256 signature verification
pay listen --port 4242 --secret my_webhook_signing_secret

# 3. Listener with signature verification + proxy forwarding to local backend
pay listen --port 4242 --secret my_webhook_secret --forward http://localhost:3000/api/webhooks

🤖 Model Context Protocol (MCP) 統合

AIアシスタントを自律的な請求・決済オペレーターに変身させます。

1. VS Code / GitHub Copilot への追加(.vscode/mcp.json

{
  "mcpServers": {
    "unified-pay": {
      "command": "npx",
      "args": ["-y", "unified-pay-cli", "mcp"]
    }
  }
}

2. 利用可能なAIツール

ツール名

説明

create_payment_link

カスタム金額、通貨、メモ付きのチェックアウトURLを作成します。

list_transactions

最近のチャージと検証ステータスを取得します。

get_payment_status

特定の支払いID(pay_xxx、ch_xxx)のライフサイクル状態を照会します。

create_refund

全額または部分返金をトリガーします。

get_refund_status

返金ID(rfnd_xxx、re_xxx)のライブステータスを追跡します。

list_refunds

過去の返金記録を一覧表示します。

verify_webhook_signature

受信したStripe/RazorpayペイロードのHMAC-SHA256真正性を検証します。

3. AIプロンプトの例

Use unified-pay to generate a INR 3,500 Razorpay payment link for "2-Hour Technical Consultation" and draft a WhatsApp message for the client.
Check if payment ID pay_Oq7Jk8LmNx9 on Razorpay was successfully captured.
Issue a full refund for Stripe charge ch_3Mtw1234 using unified-pay.
Verify if this incoming Razorpay webhook payload and signature are authentic using my signing secret.

🧪 テストと検証

# Run unit tests
npm test

# Run tests in watch mode
npm run test:watch

🛠️ 開発

# 1. Clone the repository
git clone https://github.com/your-username/unified-pay-cli.git
cd unified-pay-cli

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

# 4. Symlink globally for local testing
npm link

📄 ライセンス

MITライセンスの下で配布されています。詳細はLICENSEを参照してください。

A
license - permissive license
-
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Related MCP Servers

  • A
    license
    -
    quality
    D
    maintenance
    Centralizes payment gateway integrations for Pagar.me (customers, recipients, Pix, credit card, splits, charges) and Woovi/OpenPix (Pix charges, refunds, webhook verification) through MCP tools.
    9
    MIT
  • A
    license
    -
    quality
    B
    maintenance
    37 MCP servers for agentic commerce and Brazilian services. Covers Stripe ACP, x402 (Coinbase), AP2 (Google), Google UCP, plus 14 traditional Brazilian payment rails, fiscal, banking, communication, logistics, ERP, identity, and crypto APIs. ~480 tools. Supports stdio and Streamable HTTP.
    267
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Universal billing gateway for MCP servers. Add Stripe subscription billing to any MCP server with one line of code. Supports tiered plans, usage tracking, and automatic access control.
    1
    1
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    An MCP (Model Context Protocol) server that connects AI assistants like Claude directly to your Razorpay account.
    14
    33
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • A paid remote MCP for CLI tool MCP, built to return verdicts, receipts, usage logs, and audit-ready

  • Agent-commerce MCP server for x402/USDC payments and affiliate splits on Base.

  • MCP server integrating with Stripe - tools for customers, products, payments, and more.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pritam825/unified-pay-cli'

If you have feedback or need assistance with the MCP directory API, please join our Discord server