English Français العربية

HitPay MCP Server

السجل الرسمي المالية والمدفوعات

Official HitPay MCP: sales, payouts, balances; create payment links and invoices. OAuth; no refunds.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http hitpay-mcp-server 'https://mcp.hit-pay.com/'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "hitpay-mcp-server": {
            "type": "http",
            "url": "https://mcp.hit-pay.com/"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. HitPay Plugin for Claude Code
  2. What's Inside
  3. Installation
  4. Setup
  5. Skills
  6. Commands
  7. MCP Tools
  8. Supported Markets
  9. Security
  10. License

HitPay Plugin for Claude Code

Zero-config SEA payment integration for Claude Code. Gives Claude deep knowledge of HitPay's payment gateway plus live API access — so when developers ask for payment integration, Claude scaffolds production-ready code with the right payment methods, webhook handling, and checkout flows.

What's Inside

LayerWhat It DoesFiles
MCP ServerLive API access — create payments, check statuses, query account.mcp.json
SkillsTeach Claude correct code patterns for HitPay integrationskills/ (5 skills)
CommandsDeveloper actions — scaffold, lookup, test, QR checkoutcommands/ (4 commands)

Installation

/plugin marketplace add hit-pay/claude-code-plugin
/plugin install hitpay@hitpay-plugins
Local Development
git clone https://github.com/hit-pay/claude-code-plugin.git hitpay-plugin
claude --plugin-dir ./hitpay-plugin

Setup

Set your HitPay API credentials:

export HITPAY_API_KEY=your_api_key_here
export HITPAY_SALT=your_webhook_salt_here

Get these from your HitPay Dashboard under Settings > Payment Gateway > API Keys.

Skills

Skills are auto-invoked when Claude detects relevant context in your conversation.

SkillTriggers OnWhat It Teaches
payment-integration"add HitPay", "payment checkout", "accept payments"API routes, redirect/QR/selector flows, auth headers, test cards
webhook-handler"webhook signature", "payment notification", "verify webhook"HMAC-SHA256 verification, event types, IP allowlisting, idempotency
payment-methods"methods in Malaysia", "which payment methods", "supported methods"Country-to-method mapping, API values, currencies, unavailable methods
drop-in-ui"embed payment form", "HitPay.js", "checkout popup"HitPay.js script, init options, Next.js integration, event handling
qr-checkout"QR checkout page", "QR payment page", "show QR code for PayNow"Pre-rendered QR images, local HTML page, offline-capable, no CDN

Commands

CommandDescriptionExample
/hitpay:initScaffold a complete integration/hitpay:init nextjs sg,my
/hitpay:methodsLook up payment methods by country/hitpay:methods ph
/hitpay:webhook-testGenerate test webhook payload + curl/hitpay:webhook-test charge.created
/hitpay:qr-checkoutGenerate QR payment page with scannable codes/hitpay:qr-checkout 100 sgd paynow,qris

MCP Tools

When HITPAY_API_KEY is set, Claude can use these tools during development:

Read Operations
  • get_account_status — Check KYC and enabled providers
  • get_balances — Current account balances
  • get_payment_request — Payment request details
  • list_payment_requests — List payment requests
  • list_charges — List charges with filters
  • get_charge_detail — Charge details
  • list_customers — List customers
  • get_customer — Customer details
  • list_invoices — List invoices
  • list_subscription_plans — Subscription plans
  • list_static_qrs — Static QR codes
  • get_supported_qr_methods — Available QR methods
  • get_account_info — Account summary
Create Operations
  • create_payment_request — Create payment with checkout URL
  • create_customer — Create customer record
  • create_invoice — Create invoice
  • create_embedded_qr — Generate QR for payment collection
  • create_static_qr — Create permanent QR (POS)
  • create_webhook_event — Register webhook URL
  • create_recurring_billing — Set up subscription

Supported Markets

MarketCurrencyKey Methods
SingaporeSGDPayNow, GrabPay, ShopeePay, Cards
MalaysiaMYRGrabPay, ShopeePay, Touch 'n Go, FPX
PhilippinesPHPQR Ph, GCash, ShopeePay
ThailandTHBPromptPay, TrueMoney
VietnamVNDVietQR, ZaloPay
IndonesiaIDRQRIS
IndiaINR→SGDUPI
AustraliaAUDPayTo
Cross-borderAuto FX9 borderless QR methods

Security

This plugin follows a safe-by-default approach:

  • Included: Read operations + payment creation (reversible/safe)
  • Excluded from skills: Refunds, deletions, transfers, cancellations (destructive/financial operations)
  • Webhook verification: All generated webhook handlers include HMAC-SHA256 signature checks
  • API keys: Never exposed client-side in generated code

License

MIT

الأسئلة الشائعة

ما هو HitPay MCP Server؟

Official HitPay MCP: sales, payouts, balances; create payment links and invoices. OAuth; no refunds.

كيف أثبّت HitPay MCP Server؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http hitpay-mcp-server 'https://mcp.hit-pay.com/'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج HitPay MCP Server إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل HitPay MCP Server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون HitPay MCP Server؟

ينشره hit-pay. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.