HitPay MCP Server

Claude Code 的 HitPay 插件

Claude Code 的零配置东南亚支付集成。让 Claude 深入了解 HitPay 支付网关，并能实时访问 API——因此，开发者提出支付集成需求时，Claude 可以搭建好可用于生产环境的代码，正确处理支付方式、Webhook 和结账流程。

内容概览

层级	功能	文件
MCP 服务	实时访问 API——创建付款、查询状态、查询账户	.mcp.json
技能	教 Claude 正确的 HitPay 集成代码模式	skills/（5 个技能）
命令	开发者操作——搭建、查询、测试、QR 结账	commands/（4 个命令）

安装

通过 Marketplace 安装（推荐）

/plugin marketplace add hit-pay/claude-code-plugin
/plugin install hitpay@hitpay-plugins

本地开发

git clone https://github.com/hit-pay/claude-code-plugin.git hitpay-plugin
claude --plugin-dir ./hitpay-plugin

设置

设置 HitPay API 凭据：

export HITPAY_API_KEY=your_api_key_here
export HITPAY_SALT=your_webhook_salt_here

前往 HitPay 控制面板，在 Settings > Payment Gateway > API Keys 下获取这些凭据。

技能

Claude 在对话中检测到相关上下文时会自动调用技能。

技能	触发条件	教授内容
payment-integration	“add HitPay”、“payment checkout”、“accept payments”	API 路由、重定向/QR/选择器流程、身份验证标头、测试卡
webhook-handler	“webhook signature”、“payment notification”、“verify webhook”	HMAC-SHA256 验证、事件类型、IP 允许列表、幂等性
payment-methods	“methods in Malaysia”、“which payment methods”、“supported methods”	国家与支付方式的映射、API 值、货币、不支持的支付方式
drop-in-ui	“embed payment form”、“HitPay.js”、“checkout popup”	HitPay.js 脚本、初始化选项、Next.js 集成、事件处理
qr-checkout	“QR checkout page”、“QR payment page”、“show QR code for PayNow”	预渲染的 QR 图片、本地 HTML 页面、支持离线使用、无需 CDN

命令

命令	描述	示例
/hitpay:init	搭建完整的集成	/hitpay:init nextjs sg,my
/hitpay:methods	按国家查询支付方式	/hitpay:methods ph
/hitpay:webhook-test	生成测试 Webhook 负载和 curl 命令	/hitpay:webhook-test charge.created
/hitpay:qr-checkout	生成带可扫描二维码的支付页面	/hitpay:qr-checkout 100 sgd paynow,qris

MCP 工具

设置 HITPAY_API_KEY 后，Claude 可以在开发过程中使用以下工具：

读取操作

• get_account_status — 检查 KYC 状态和已启用的服务提供方
• get_balances — 当前账户余额
• get_payment_request — 支付请求详情
• list_payment_requests — 列出支付请求
• list_charges — 按筛选条件列出扣款
• get_charge_detail — 扣款详情
• list_customers — 列出客户
• get_customer — 客户详情
• list_invoices — 列出发票
• list_subscription_plans — 订阅计划
• list_static_qrs — 静态二维码
• get_supported_qr_methods — 可用的 QR 支付方式
• get_account_info — 账户摘要

创建操作

• create_payment_request — 创建包含结账 URL 的付款
• create_customer — 创建客户记录
• create_invoice — 创建发票
• create_embedded_qr — 生成收款二维码
• create_static_qr — 创建永久二维码（POS）
• create_webhook_event — 注册 Webhook URL
• create_recurring_billing — 设置订阅

支持的市场

市场	货币	主要支付方式
新加坡	SGD	PayNow、GrabPay、ShopeePay、银行卡
马来西亚	MYR	GrabPay、ShopeePay、Touch 'n Go、FPX
菲律宾	PHP	QR Ph、GCash、ShopeePay
泰国	THB	PromptPay、TrueMoney
越南	VND	VietQR、ZaloPay
印度尼西亚	IDR	QRIS
印度	INR→SGD	UPI
澳大利亚	AUD	PayTo
跨境	自动 FX	9 种无国界二维码支付方式

安全

此插件遵循默认安全原则：

• 包含：读取操作和付款创建（可撤销／安全）
• 未纳入技能：退款、删除、转账、取消（破坏性／金融操作）
• Webhook 验证：所有生成的 Webhook 处理程序均包含 HMAC-SHA256 签名检查
• API 密钥：生成的代码绝不会在客户端公开

许可证

MIT