Lunium — Brazilian PIX and stablecoin payments

Name: Lunium — Brazilian PIX and stablecoin payments
Author: luniumpay.com

远程服务

docs.luniumpay.com金融数据04 天前更新

代码仓库访问官网

关于 Lunium — Brazilian PIX and stablecoin payments

LuniumPay Agent Skills 是一组供编码 Agent 集成巴西 Pix 与稳定币支付的技能和脚本，涵盖收款及加密货币结算、用加密货币支付 Pix、Webhook、沙盒测试和生产配置，支持多种项目技术栈。

主要功能

01为支持的技术栈生成支付路由
02在沙盒中测试支付流程
03配置生产密钥和 Webhook
04集成 Pix 收款与稳定币结算
05支持使用加密货币支付 Pix

适用场景

01添加 Pix 转 USDT/USDC 支付流程
02不动用真实资金测试成功和失败场景
03配置签名 Webhook 处理
04设置生产环境支付集成

MCP 相关

技能文档指向 LuniumPay 的 MCP 端点 https://api.luniumpay.com/mcp，该端点提供 20 个工具。项目也引导 Agent 通过 API 集成支付功能。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://api.luniumpay.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-luniumpay-pix-brazilian-payments https://api.luniumpay.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-luniumpay-pix-brazilian-payments":{"type":"http","url":"https://api.luniumpay.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-luniumpay-pix-brazilian-payments":{"type":"http","url":"https://api.luniumpay.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-luniumpay-pix-brazilian-payments":{"type":"http","url":"https://api.luniumpay.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-luniumpay-pix-brazilian-payments":{"serverUrl":"https://api.luniumpay.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
name	string	否	可选标签，便于用户稍后在控制面板中识别此密钥，例如 Agent 或项目的名称。
email	string	否	测试人员的电子邮件。强烈建议提供：LuniumPay 会向该地址发送一次集成指南（LuniumPay 是什么、手册、流程图、后续步骤）。请向用户索取，切勿编造。如果暂时没有，请照常创建密钥，之后通过 lunium_contact 发送。

详细介绍

LuniumPay Agent Skills

PT · 巴西 Pix ⇄ 稳定币，由你的 AI Agent 集成。安装后，只需提出 “我想收取 Pix，并将资金结算为 USDT 到我的钱包”，Agent 就会完成所有工作：一次调用获取密钥、配置后端、生成 QR 码、设置 webhook、使用沙盒并部署到生产环境。 EN · 巴西 Pix ↔ 稳定币支付，由你的编码 Agent 集成。安装后，只需提出“接受 Pix，并将资金结算为 USDT 到我的钱包”，Agent 就会处理其余所有工作。

适用于 Claude Code、Cursor、Codex、Gemini CLI、Windsurf、Antigravity，以及任何支持读取 Agent Skills 标准的 Agent。

安装 / Install

npx skills add LuniumPay/lunium-agent-skills

通过插件市场安装 Claude Code 版本（可接收更新）：

/plugin marketplace add LuniumPay/lunium-agent-skills
/plugin install luniumpay@lunium-agent-skills

手动安装：将文件夹复制到 Agent 的 skills 目录（.claude/skills/、.cursor/skills/、.codex/skills/、.agents/skills/）。

包含内容 / What's inside

Skill	适用场景…	附加内容
`luniumpay`	从这里开始。产品介绍、决策树、7 步操作指南、11 条规则、沙盒模拟内容	`references/` 状态、错误、检查清单、商户常见问题、提示词、MCP（20 个工具）、各技术栈的生产环境指南 · `scripts/init.mjs`、`doctor.mjs`、`go-live.mjs`
`luniumpay-pix-charge`	接收 Pix → 将资金结算为 USDT/USDC 到钱包（或余额）	Next.js、Express、FastAPI、Supabase Edge 示例；React 结账组件 · `scripts/smoke.mjs`
`luniumpay-custody`	无需钱包即可持有雷亚尔余额、子账户、资金保留/等待期、加密货币提现、使用余额支付 Pix	`scripts/smoke-custody.mjs`（包含等待期）
`luniumpay-webhooks`	安全接收已签名的事件	官方验证器 + 测试
`luniumpay-crypto-sale`	使用加密货币支付 Pix（资金兑出）：目录、预览、订单、接受、退款	`scripts/smoke-cashout.mjs`
`luniumpay-usdt-wallet`	持有 USDT 余额，并用其支付 Pix（通过密钥或复制粘贴）
`luniumpay-verify-payment`	无需密钥即可证明 Pix 已结算

一条命令将脚手架搭建到你的项目中 / Scaffold into your project

node luniumpay/scripts/init.mjs --email [email protected]      # detecta Next.js, Express, FastAPI ou Supabase

将官方示例中的收款、状态和 webhook 路由写入你的项目（绝不覆盖现有内容），写入 .env.example，在本地 .env 中创建一个沙盒密钥（权限为 0600，绝不打印），并列出后续步骤。 --stack next|express|fastapi|supabase 用于指定技术栈；--dry 仅显示计划。

无需资金即可测试 / Try with no money

export [email protected]     # recebe 1 e-mail com o manual
node luniumpay/scripts/doctor.mjs                 # diagnóstico da chave (após criar)
node luniumpay-pix-charge/scripts/smoke.mjs cripto success
node luniumpay-pix-charge/scripts/smoke.mjs cripto failed
node luniumpay-custody/scripts/smoke-custody.mjs
node luniumpay-crypto-sale/scripts/smoke-cashout.mjs USDT polygon
node luniumpay-crypto-sale/scripts/smoke-cashout.mjs DEPIX liquid settlement_uncertain
node luniumpay-webhooks/scripts/verify-webhook.test.mjs

脚本会创建一个测试密钥（lun_test_），发起收款、模拟 Pix 支付并读取最终状态。脚本会拒绝生产密钥。不会发生真实资金转移。

一条命令完成生产环境配置 / Production in one command

node luniumpay/scripts/go-live.mjs --name "Minha Empresa" --email [email protected] \
  --webhook https://seu-dominio.com/api/webhooks/lunium --vercel     # ou --env .env.lunium.production

立即创建 lun_live_… 密钥（无需审批），注册带有密钥的 webhook，将密钥安全写入主机（绝不打印），并通过 POST /webhooks/test 验证事件已送达。沙盒与生产环境使用相同的合约：只需更改变量。各技术栈的部署及首次真实收款指南：luniumpay/references/producao.md。

仅获取密钥，可通过 curl 操作：curl -X POST https://api.luniumpay.com/keys -H 'Content-Type: application/json' -d '{"name":"Minha Empresa","email":"[email protected]"}'。

唯一可信来源 / Source of truth

SKILL.md 刻意保持简短。以实时合约为准： openapi.json · llms.txt · integration.json · 沙盒 · MCP https://api.luniumpay.com/mcp。Skills 2.2.0 · 修订日期 2026-10-25 · API 1.45.2。

支持：[email protected] · https://wa.me/27722944340 · Lunium Partners（Telegram）