核心用法
moneydevkit 是面向开发者的支付基础设施 SDK，基于 Bitcoin Lightning 网络实现全球即时收款。核心工作流分为四步：获取凭证（通过 MCP 服务器、CLI 或 Dashboard）→ 选择框架（Next.js 或 Replit Express+Vite）→ 创建商品（可选，支持固定定价与 pay-what-you-want）→ 部署上线。
凭证获取：提供双模式 MCP 服务器——未认证端用于创建账户和生成凭证，认证端用于完整账户管理。生成 MDK_ACCESS_TOKEN 和 MDK_MNEMONIC 两个关键环境变量，需配置至生产环境。CLI 方式通过 npx @moneydevkit/create 一键初始化。
框架集成：Next.js 指南位于 references/nextjs.md，Replit 指南位于 references/replit.md，均提供标准化接入流程。
支付模式：
AMOUNT类型：动态金额场景（打赏、发票），需指定amount和currencyPRODUCTS类型：销售预配置商品，通过productID 引用
定价与货币：支持 USD（美分单位）和 SAT（聪，Bitcoin 最小单位）。amountType: 'CUSTOM' 启用自主定价模式。
客户管理：可通过 customer 字段收集邮箱、姓名、外部 ID，并设置 requireCustomerData 强制表单收集。
显著优点
1. 零银行账户门槛：纯 Bitcoin Lightning 架构，服务传统金融体系覆盖不足地区的开发者
2. 极速集成：官方宣称 5 分钟完成接入，MCP 服务器支持 AI 助手直接调用管理工具
3. 灵活定价模型：固定价格 + 自主定价双模式，适应订阅、捐赠、数字商品等多种场景
4. 开发者体验优先：TypeScript 友好，环境变量配置简洁，CLI 和 MCP 双轨制降低使用门槛
5. 全栈工具链：从账户创建、商品管理、客户追踪到订单查询的完整 MCP 工具集
潜在缺点与局限性
1. 加密货币依赖：收款端以 Bitcoin Lightning 结算，需承担 BTC 价格波动风险；用户端需 Lightning 钱包支持
2. 生态锁定：仅支持 Next.js 和 Replit 两种框架，Vue、SvelteKit、原生移动端等场景需自行适配
3. 凭证安全敏感：MDK_MNEMONIC 为钱包助记词，泄露即等同于资金被盗，无多签或硬件钱包支持
4. 监管不确定性：加密货币支付在全球各地合规状态不一，商用需自行评估当地法规
5. 退款机制模糊：文档提及客户数据用于"enable refunds"，但未说明具体操作流程和资金退回路径
6. 文档深度不足：部分关键操作（如生产环境安全加固、大额交易风控）缺乏详细指引
适合人群
- 独立开发者/小团队：快速为 side project 或 MVP 添加支付功能
- 全球数字商品/服务卖家：面向无信用卡用户群体
- 加密货币原生项目：需 Lightning 网络集成的 Bitcoin 生态应用
- AI 驱动开发：习惯通过 Claude 等 MCP 客户端管理基础设施的开发者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露 | `MDK_MNEMONIC` 和 `MDK_ACCESS_TOKEN` 需严格保密，建议使用密钥管理服务而非明文 `.env` |
| 部署配置错误 | 文档特别提醒使用 `printf` 而非 `echo` 管道环境变量，尾部换行符会导致静默认证失败 |
| 汇率波动 | BTC 计价收款面临法币折算波动，需考虑实时对冲或稳定币转换方案 |
| 合规风险 | 部分司法辖区要求加密货币支付服务注册或持牌，商用前建议法律咨询 |
| 单点故障 | 依赖 moneydevkit 托管的 Lightning 节点，服务中断可能影响收款 |