unified-pay-cli
💳 unified-pay-cli
Stripe, Razorpay 및 LemonSqueezy를 위한 범용 결제 게이트웨이 CLI 및 MCP(Model Context Protocol) 서버
🚀 주요 기능
⚡ 설치 불필요:
npx unified-pay-cli로 즉시 실행 가능.🎯 멀티 프로바이더 엔진: Stripe, Razorpay, LemonSqueezy를 통일된 인터페이스로 제공.
🛠️ 스마트 결제 링크 생성: 대화형 터미널 UI 프롬프트 또는 직접 스크립트 CLI 플래그 지원.
🔄 전체 트랜잭션 및 환불 생애주기: 실시간 상태 확인, 최근 트랜잭션 목록, 부분/전액 환불, 전용 환불 진행 추적.
📡 웹훅 스테이션 및 포워딩 프록시: 내장 HTTP 리스너(
pay listen)가 웹훅 이벤트를 가로채 색상 코드로 표시하고 로컬 백엔드(--forward http://localhost:3000/api/webhooks)로 직접 전달.🔒 암호화 서명 검증: 내장 HMAC-SHA256 검증(
--secret)으로 위조되거나 변조된 웹훅 페이로드로부터 로컬 개발 환경 보호.🤖 네이티브 MCP(Model Context Protocol): 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 --help2. 자격 증명 구성
# 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 razorpay3. 환불 발행 및 추적 (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 razorpay4. 웹훅 스테이션, 검증 및 프록시 (pay listen)
복잡한 터널링 설정 없이 로컬 개발 중 실시간 웹훅 이벤트를 캐치합니다:
# 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🤖 MCP(Model Context Protocol) 통합
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 파일을 참조하세요.
This server cannot be installed
Maintenance
Related MCP Servers
- Alicense-qualityDmaintenanceCentralizes payment gateway integrations for Pagar.me (customers, recipients, Pix, credit card, splits, charges) and Woovi/OpenPix (Pix charges, refunds, webhook verification) through MCP tools.9MIT
- Alicense-qualityBmaintenance37 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.267MIT
- AlicenseBqualityDmaintenanceUniversal 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.11MIT
- AlicenseBqualityDmaintenanceAn MCP (Model Context Protocol) server that connects AI assistants like Claude directly to your Razorpay account.14331MIT
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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