The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the HitPay MCP Server listing page.
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.
| 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) |
Set your HitPay API credentials:
Get these from your HitPay Dashboard under Settings > Payment Gateway > API Keys.
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 |
| 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 |
When HITPAY_API_KEY is set, Claude can use these tools during development:
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 summarycreate_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| 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 |
This plugin follows a safe-by-default approach:
MIT