Skip to main content
Glama

💳 unified-pay-cli

El CLI Universal de Pasarela de Pago y Servidor de Protocolo de Contexto de Modelo (MCP) para Stripe, Razorpay y LemonSqueezy.

npm version License: MIT MCP Protocol PRs Welcome


🚀 Destacados

  • Sin Instalación Requerida: Ejecútalo al instante bajo demanda mediante npx unified-pay-cli.

  • 🎯 Motor Multi-Proveedor: Interfaz estandarizada para Stripe, Razorpay y LemonSqueezy.

  • 🛠️ Generación Inteligente de Enlaces de Pago: Indicaciones interactivas en terminal o banderas CLI directas para scripts.

  • 🔄 Ciclo de Vida Completo de Transacciones y Reembolsos: Verificaciones de estado en vivo, listados de transacciones recientes, reembolsos parciales/totales y seguimiento dedicado del progreso de reembolsos.

  • 📡 Estación de Webhook y Proxy de Reenvío: Oyente HTTP integrado (pay listen) que intercepta, colorea y reenvía eventos de webhook directamente a tu backend local (--forward http://localhost:3000/api/webhooks).

  • 🔒 Verificación de Firma Criptográfica: Verificación HMAC-SHA256 integrada (--secret) que protege tu desarrollo local de cargas útiles de webhook falsificadas o alteradas.

  • 🤖 Protocolo de Contexto de Modelo (MCP) Nativo: Conecta tu stack de pagos a GitHub Copilot, Cursor o Claude Desktop para que la IA pueda crear enlaces, verificar firmas y rastrear facturas a partir de indicaciones en lenguaje natural.


Related MCP server: mcp-dev-brasil

⚡ Inicio Rápido

1. Instalación

Instálalo globalmente o ejecútalo bajo demanda mediante 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. Configurar Credenciales

# 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

💻 Referencia de Comandos CLI

1. Crear Enlaces de Pago (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. Inspeccionar Transacciones (pay txn)

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

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

3. Emitir y Rastrear Reembolsos (pay refund)

pay maneja el ciclo de vida separado de cargos frente a entidades de reembolso:

# 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. Estación de Webhook, Verificación y Proxy (pay listen)

Captura eventos de webhook en tiempo real durante el desarrollo local sin configuraciones complejas de túneles:

# 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

🤖 Integración del Protocolo de Contexto de Modelo (MCP)

Convierte a tu asistente de IA en un operador autónomo de facturación y pagos.

1. Agregar a VS Code / GitHub Copilot (.vscode/mcp.json)

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

2. Herramientas de IA Disponibles

Nombre de la Herramienta

Descripción

create_payment_link

Crea URLs de pago con monto, moneda y nota personalizados.

list_transactions

Obtiene cargos recientes y estados de verificación.

get_payment_status

Inspecciona el estado del ciclo de vida de un ID de pago específico (pay_xxx, ch_xxx).

create_refund

Activa un reembolso total o parcial.

get_refund_status

Rastrea el estado en vivo de un ID de reembolso (rfnd_xxx, re_xxx).

list_refunds

Lista registros históricos de reembolsos.

verify_webhook_signature

Verifica la autenticidad HMAC-SHA256 de cargas útiles entrantes de Stripe/Razorpay.

3. Ejemplos de Indicaciones para IA

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.

🧪 Pruebas y Verificación

# Run unit tests
npm test

# Run tests in watch mode
npm run test:watch

🛠️ Desarrollo

# 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

📄 Licencia

Distribuido bajo la Licencia MIT. Consulta LICENSE para más detalles.

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