HitPay MCP Server
Official HitPay MCP: sales, payouts, balances; create payment links and invoices. OAuth; no refunds.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http hitpay-mcp-server 'https://mcp.hit-pay.com/'
{
"mcpServers": {
"hitpay-mcp-server": {
"type": "http",
"url": "https://mcp.hit-pay.com/"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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
| Layer | What It Does | Files |
|---|---|---|
| MCP Server | Live API access — create payments, check statuses, query account | .mcp.json |
| Skills | Teach Claude correct code patterns for HitPay integration | skills/ (5 skills) |
| Commands | Developer actions — scaffold, lookup, test, QR checkout | commands/ (4 commands) |
Installation
Via Marketplace (recommended)
/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.
| Skill | Triggers On | What 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
| Command | Description | Example |
|---|---|---|
/hitpay:init | Scaffold a complete integration | /hitpay:init nextjs sg,my |
/hitpay:methods | Look up payment methods by country | /hitpay:methods ph |
/hitpay:webhook-test | Generate test webhook payload + curl | /hitpay:webhook-test charge.created |
/hitpay:qr-checkout | Generate 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 providersget_balances— Current account balancesget_payment_request— Payment request detailslist_payment_requests— List payment requestslist_charges— List charges with filtersget_charge_detail— Charge detailslist_customers— List customersget_customer— Customer detailslist_invoices— List invoiceslist_subscription_plans— Subscription planslist_static_qrs— Static QR codesget_supported_qr_methods— Available QR methodsget_account_info— Account summary
Create Operations
create_payment_request— Create payment with checkout URLcreate_customer— Create customer recordcreate_invoice— Create invoicecreate_embedded_qr— Generate QR for payment collectioncreate_static_qr— Create permanent QR (POS)create_webhook_event— Register webhook URLcreate_recurring_billing— Set up subscription
Supported Markets
| Market | Currency | Key Methods |
|---|---|---|
| Singapore | SGD | PayNow, GrabPay, ShopeePay, Cards |
| Malaysia | MYR | GrabPay, ShopeePay, Touch 'n Go, FPX |
| Philippines | PHP | QR Ph, GCash, ShopeePay |
| Thailand | THB | PromptPay, TrueMoney |
| Vietnam | VND | VietQR, ZaloPay |
| Indonesia | IDR | QRIS |
| India | INR→SGD | UPI |
| Australia | AUD | PayTo |
| Cross-border | Auto FX | 9 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
Questions fréquentes
Qu'est-ce que HitPay MCP Server ?
Official HitPay MCP: sales, payouts, balances; create payment links and invoices. OAuth; no refunds.
Comment installer HitPay MCP Server ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http hitpay-mcp-server 'https://mcp.hit-pay.com/'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour HitPay MCP Server ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
HitPay MCP Server est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient HitPay MCP Server ?
Il est publié par hit-pay. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.