Skip to main content
The HitPay Claude Code Plugin is the first AI payment gateway plugin for Claude Code. It connects Claude to HitPay’s live payment API through an MCP server with 28 tools, 5 auto-triggered skills, and 4 slash commands — enabling developers to build complete payment integrations by describing what they need in natural language instead of reading API documentation.

​
Plugin vs. Agent Skills

HitPay offers two AI integration approaches. Choose the one that fits your workflow.
FeatureClaude Code PluginAgent Skills
Installationclaude plugin add hit-pay/claude-code-pluginnpx skills add hit-pay/agent-skills
Live API access28 MCP tools (read + safe create)None — code generation only
Auto-triggered skills5 (payment, webhook, methods, UI, QR)2 (payment, webhook)
Slash commands4 (/hitpay:init, /hitpay:methods, etc.)None
AI assistantsClaude Code onlyClaude Code, Cursor, Copilot, Windsurf
Sandbox supportBuilt-in (default environment)Via env vars
Destructive operationsExcluded by designN/A
If you use Cursor, GitHub Copilot, or Windsurf, use Agent Skills instead — the Claude Code Plugin is exclusive to Claude Code.

​
What’s Included

MCP Server

28 live API tools — create payment requests, list charges, manage customers, generate QR codes, and more. All operations are read or safe-create.

5 Auto-Triggered Skills

Claude automatically activates the right skill based on your prompt — payment integration, webhook handling, method lookup, embedded UI, or QR checkout.

4 Slash Commands

Scaffolding commands for common workflows: /hitpay:init, /hitpay:methods, /hitpay:webhook-test, /hitpay:qr-checkout.

​
Installation

1

Install the plugin

Install from the Claude Code marketplace:
claude plugin add hit-pay/claude-code-plugin
Or clone locally for development:
git clone https://github.com/hit-pay/claude-code-plugin.git hitpay-plugin
claude --plugin-dir ./hitpay-plugin
2

Set environment variables

Add your HitPay API credentials:
export HITPAY_API_KEY=your_api_key_here
export HITPAY_SALT=your_webhook_salt_here
export HITPAY_ENV=sandbox
Get your API key from Dashboard → Settings → Payment Gateway → API Keys. Get your webhook salt from Dashboard → Settings → Developers → Webhook Endpoints.
3

Start building

Open Claude Code and describe what you want:
"Add PayNow and GrabPay to my Next.js checkout"
Claude will use the live API and auto-triggered skills to generate production-ready code.
Always start with HITPAY_ENV=sandbox. Switch to HITPAY_ENV=production only when you are ready to accept real payments. The plugin defaults to sandbox mode.

​
MCP Server — 28 API Tools

The plugin’s MCP server gives Claude live access to the HitPay API. All operations are either read-only or safe-create — no destructive operations are exposed.
CategoryToolsOperations
Payment Requests5Create, get, list, update, delete (pending only)
Charges2List charges, get charge detail
Account & Balances2Get balances, get account status
Customers3Create, list, get
Invoices2Create, list
QR Codes4Get supported methods, create embedded QR, create/list static QR
Subscriptions4List plans, create/cancel billing, charge saved card
Webhooks3Create/delete webhook events, get remitter
Analytics1Get sales summary
Products2List products, get account info
Refunds, transfers, and bulk deletions are intentionally excluded. The plugin is designed to be safe to use with production API keys — Claude cannot trigger irreversible financial operations.

​
Auto-Triggered Skills

Skills activate automatically based on what you ask Claude. No manual invocation needed.
SkillTriggers When You SayWhat It Does
payment-integration”Add HitPay”, “payment checkout”, “accept payments”Generates API routes, redirect/QR/selector checkout flows, auth headers, and test card setup
webhook-handler”webhook signature”, “verify webhook”, “payment notification”Generates HMAC-SHA256 verification (mandatory), event routing, idempotency handling
payment-methods”methods in Malaysia”, “supported methods”, “which payment methods”Returns country-to-method mapping with exact API codes, currencies, and availability
drop-in-ui”embed payment form”, “HitPay.js”, “checkout popup”Generates HitPay.js script integration, init options, Next.js component, event handling
qr-checkout”QR checkout page”, “QR payment page”, “show QR code”Generates a branded HTML page with scannable QR, countdown timer, offline-capable

​
Slash Commands

CommandDescriptionExample
/hitpay:initScaffold a complete HitPay integration for your framework and markets/hitpay:init nextjs sg,my
/hitpay:methodsLook up available payment methods by country/hitpay:methods ph
/hitpay:webhook-testGenerate a test webhook payload and curl command/hitpay:webhook-test charge.created
/hitpay:qr-checkoutGenerate a QR payment page for specific methods/hitpay:qr-checkout 100 sgd paynow,qris

​
Supported Payment Methods

The plugin covers 50+ payment methods across 8 markets with automatic cross-border support.
MarketCurrencyPayment Methods
SingaporeSGDPayNow, GrabPay, ShopeePay, Cards, Apple Pay, Google Pay
MalaysiaMYRFPX, Touch ‘n Go, DuitNow, GrabPay, ShopeePay, Boost
PhilippinesPHPGCash, Maya, QR Ph, ShopeePay
ThailandTHBPromptPay, TrueMoney
IndonesiaIDRQRIS, OVO, DANA
VietnamVNDVietQR, ZaloPay
IndiaINR→SGDUPI (with automatic FX conversion)
AustraliaAUDPayTo, Cards
Cross-borderAuto FX9 borderless QR methods with real-time exchange rates

​
Usage Examples

Prompt: “Add PayNow and card payments to my Next.js app”Claude will:
  1. Create an API route at app/api/payments/create/route.ts
  2. Generate a checkout component with redirect flow
  3. Set up webhook handler with HMAC-SHA256 verification
  4. Add environment variable configuration

​
Prerequisites

Before installing the plugin, ensure you have:
  1. HitPay Account — Create an account or use the sandbox environment
  2. API Key — Found in Settings → Payment Gateway → API Keys
  3. Webhook Salt — Found in Settings → Developers → Webhook Endpoints
  4. Claude Code — The plugin requires Claude Code (Anthropic’s CLI)

​
Frequently Asked Questions

The HitPay Claude Code Plugin is an AI-powered development tool that connects Claude Code to HitPay’s live payment API. It includes an MCP server with 28 API tools, 5 auto-triggered skills for common integration tasks, and 4 slash commands for scaffolding. Developers describe what they want in natural language, and Claude generates production-ready payment integration code.
The Claude Code Plugin provides live API access through an MCP server — Claude can create real payment requests, query charges, and check balances. Agent Skills only provide code generation templates without API connectivity. The plugin also includes slash commands and more auto-triggered skills. However, Agent Skills work with Cursor, Copilot, and Windsurf, while the plugin is Claude Code exclusive.
Yes. The plugin intentionally excludes all destructive operations — no refunds, no transfers, no bulk deletions. All 28 MCP tools are either read-only or safe-create operations. Claude cannot trigger irreversible financial actions through the plugin.
Yes. The plugin defaults to sandbox mode (HITPAY_ENV=sandbox). All API calls go to api.sandbox.hit-pay.com until you explicitly set HITPAY_ENV=production. Use test card 4242 4242 4242 4242 with any expiry and CVC in sandbox.
The plugin supports 50+ payment methods across Singapore, Malaysia, Philippines, Thailand, Indonesia, Vietnam, India, and Australia. This includes PayNow, FPX, QRIS, GrabPay, GCash, PromptPay, UPI, and 9 cross-border QR methods with automatic FX conversion.
No. The Claude Code Plugin requires Claude Code (Anthropic’s CLI) because it uses the MCP server protocol and Claude Code’s plugin system. For Cursor, GitHub Copilot, or Windsurf, use HitPay Agent Skills instead.
Change your environment variable from HITPAY_ENV=sandbox to HITPAY_ENV=production and update HITPAY_API_KEY to your production API key. Your production key is found in your live HitPay Dashboard under Settings → Payment Gateway → API Keys.
The plugin is optimized for Next.js (App Router) but works with any Node.js/TypeScript framework. Claude adapts the generated code for Express, Fastify, Remix, SvelteKit, or vanilla Node.js based on your project structure.

​
Resources

GitHub Repository

View source, report issues, and contribute

API Reference

Full API documentation

Webhook Events

Handle payment notifications

Sandbox Guide

Test your integration

Agent Skills

Alternative for Cursor, Copilot, and Windsurf

Payment Methods

Full payment method reference

​
Feedback

Have suggestions or found an issue? Open an issue on GitHub.