neutronpay

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Neutronpay

Overview

概述

Integrate Neutronpay for agent-driven payments. Use this skill when tasks involve wiring the Neutron MCP server into AI tools (Cursor/Claude/Windsurf), building Neutron SDK backends, running Neutron AI-agent templates, or adding Lightning checkout flows in React apps.

集成Neutronpay以实现Agent驱动的支付。当任务涉及将Neutron MCP服务器接入AI工具（Cursor/Claude/Windsurf）、构建Neutron SDK后端、运行Neutron AI-Agent模板，或在React应用中添加Lightning结账流程时，可使用本技能。

Environment

环境要求

Requires
```
bash
```
,
```
curl
```
, Node.js, and
```
npx
```
.
Requires Neutron credentials from
```
portal.neutron.me
```
.
Requires internet access to Neutron services and npm.

Use this skill for implementation and operations, not generic payments theory.

需要
```
bash
```
、
```
curl
```
、Node.js及
```
npx
```
。
需要从
```
portal.neutron.me
```
获取Neutron凭证。
需要能够访问Neutron服务与npm的网络环境。

本技能适用于实现与运维场景，不适用于通用支付理论相关内容。

Workflow

工作流

Pick the integration path first:

MCP-first AI tool integration (
```
neutron-mcp
```
) for assistants using tool calls.
SDK backend integration (
```
neutron-sdk
```
) for invoices/payments/status APIs.
Agent runtime template (
```
neutron-ai-agent
```
) for pay-per-task automation.
Frontend checkout (
```
neutron-react-payment-component
```
) backed by SDK endpoints.

Run preflight checks:

```
scripts/check-neutron-prereqs.sh mcp
```
for MCP configuration work.
```
scripts/check-neutron-prereqs.sh sdk
```
for backend SDK work.

scripts/check-neutron-prereqs.sh agent

for

neutron-ai-agent

flows.

Configure MCP from mcp-sdk-agent-integration:

Add MCP server config to tool-specific settings.
Inject
```
NEUTRON_API_KEY
```
and
```
NEUTRON_API_SECRET
```
via environment.
Restart/reload MCP and verify tool calls.

Implement Neutron API path:

For MCP usage: validate balance lookup and invoice creation end-to-end.
For SDK usage: wire
```
lightning.createInvoice
```
, transaction status checks, and webhook handling.
For agent usage: wire webhook secret validation and payment-to-task completion flow.

Apply safety and policy controls:

Never commit live API keys/secrets.
Use per-environment credentials and explicit spend/risk limits.
Require human confirmation for high-value sends.

首先选择集成路径：

面向使用工具调用的助手的MCP优先AI工具集成（
```
neutron-mcp
```
）。
用于发票/支付/状态API的SDK后端集成（
```
neutron-sdk
```
）。
用于按任务付费自动化的Agent运行时模板（
```
neutron-ai-agent
```
）。
由SDK端点提供支持的前端结账（
```
neutron-react-payment-component
```
）。

运行预检检查：

执行
```
scripts/check-neutron-prereqs.sh mcp
```
以进行MCP配置工作。
执行
```
scripts/check-neutron-prereqs.sh sdk
```
以进行后端SDK工作。

执行

scripts/check-neutron-prereqs.sh agent

以进行

neutron-ai-agent

流程的检查。

参考mcp-sdk-agent-integration配置MCP：

将MCP服务器配置添加至工具专属设置中。
通过环境变量注入
```
NEUTRON_API_KEY
```
与
```
NEUTRON_API_SECRET
```
。
重启/重载MCP并验证工具调用功能。

实现Neutron API路径：

对于MCP使用场景：端到端验证余额查询与发票创建功能。
对于SDK使用场景：对接
```
lightning.createInvoice
```
、交易状态检查及Webhook处理。
对于Agent使用场景：对接Webhook密钥验证及支付到任务完成的流程。

应用安全与策略控制：

切勿提交生产环境的API密钥/密钥。
使用分环境凭证及明确的支出/风险限额。
高价值转账需人工确认。

Quick Commands

快速命令

bash

undefined

bash

undefined

MCP preflight

MCP预检

scripts/check-neutron-prereqs.sh mcp

Run Neutron MCP server

运行Neutron MCP服务器

npx -y neutron-mcp

SDK install in a repo

在仓库中安装SDK

npm install neutron-sdk

undefined

npm install neutron-sdk

undefined

Reference Files

参考文件

mcp-sdk-agent-integration: MCP setup, SDK entrypoints, agent template, and checkout wiring.

mcp-sdk-agent-integration：MCP设置、SDK入口、Agent模板及结账流程对接说明。