使用说明
克劳德代码的HitPay插件
Claude Code的零配置SEA支付集成。让Claude深入了解HitPay的支付网关以及实时API访问-因此,当开发人员要求进行支付集成时,Claude会使用正确的支付方法、webhook处理和结账流程构建生产就绪代码。
里面是什么
| 图层 | 功能 | 文件 |
|---|---|---|
| MCP服务器 | 实时API访问-创建付款、检查状态、查询帐户 | .mcp.json |
| 技能 | 教Claude正确的HitPay集成代码模式 | skills/ (5项技能) |
| 命令 | 开发人员操作——脚手架、查找、测试、二维码检查 | commands/ (4个命令) |
安装
通过市场(推荐)
/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仪表板 在“设置”>“支付网关”>“API密钥”下。
技能
当克劳德在你的对话中检测到相关上下文时,技能会自动调用。
| 技能 | 触发 | 它教什么 |
|---|---|---|
| 支付集成 | “添加HitPay”、“付款结算”、“接受付款” | API路由、重定向/QR/选择器流、验证头、测试卡 |
| webhook处理程序 | “webhook签名”、“支付通知”、“验证webhook” | HMAC-SHA256验证、事件类型、IP分配、幂等性 |
| 付款方式 | “马来西亚的方法”、“哪些支付方法”、支持的方法 | 国家到方法映射、API值、货币、不可用的方法 |
| 插入ui | “嵌入支付表单”、“HitPay.js”、“结账弹出窗口” | HitPay.js脚本、初始化选项、Next.js集成、事件处理 |
| qr结账 | “二维码结账页面”、“二维码支付页面”和“显示PayNow二维码” | 预渲染二维码图像,本地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 URLcreate_recurring_billing--设置订阅
支持的市场
| 市场 | 货币 | 主要方法 |
|---|---|---|
| 新加坡 | 新加坡元 | PayNow、GrabPay、ShopeePay、信用卡 |
| 马来西亚 | 马来西亚令吉 | GrabPay、ShopeePay、Touch'n Go、FPX |
| 菲律宾 | PHP | QR Ph、GCash、ShopeePay |
| 泰国 | 泰铢 | PromptPay,TrueMoney |
| 越南 | VND | 扎洛佩VietQR |
| 印度尼西亚 | IDR | QRIS |
| 印度 | 印度卢比→SGD | UPI |
| 澳大利亚 | AUD | PayTo |
| 跨境 | 自动外汇 | 9种无边界二维码方法 |
安全
此插件遵循默认安全方法:
- 包含:读取操作+创建支付(可逆/安全)
- 排除在技能之外:退款、删除、转账、取消(破坏性/财务操作)
- Webhook验证:所有生成的webhook处理程序都包含HMAC-SHA256签名检查
- API密钥:从不在生成的代码中暴露客户端
许可证
麻省理工学院