Lunium。文档

智能体接入所需信息，尽在此处。

自动接入指南：从测试到生产

精确方法、前置条件、凭证、webhook 及恢复流程。Mesh 按规则自动激活，普通注册则支持无需固定钱包的托管余额。

官方接入者社区，提供运行通告、维护、API 变更及伙伴交流。强烈建议从接入初期开始关注。

配置佣金、理解费用、恢复监控访问，并按当前接口契约处理故障。

Lunium 提供 Pix 与稳定币之间的结算服务。智能体可完成服务发现、接入、验证、生产激活及交易， 在负责人授权及 API 规则范围内自动执行。本页介绍完整流程。

从这里开始

一次请求，无需密钥：

curl https://api.luniumpay.com/mesh

响应包含服务介绍、结算能力、资产与网络、全部接口、凭证获取方式、生产上线流程、限额及结构定义。当前索引包含 — 项能力和 — 种操作意图。

服务发现。 从域名开始： https://luniumpay.com 通过响应头 Link 告知 /.well-known/api-catalog 的位置（RFC 9727）。由此即可找到 /mesh ，无需事先知道接口路径。工作原理。
按照业务意图选择能力，无需熟悉平台内部术语。每项能力均声明 intent、 input_assets、 output_currencies 及 payment_rails。可按属性筛选。
注册中 POST /mesh/agents。响应同时返回 agent_id 及 lun_test_… 凭证。
完成沙盒练习。 仅获取密钥还不够：请创建 并接受报价 一笔订单，在操作真实资金之前验证错误处理流程。
验证中 POST /mesh/agents/{id}/validate。
设置收款地址 — /settlement。
设置授权限额 — /mandate。授权只能收紧自身限额，不能扩大平台策略允许的范围。了解原因。
启用生产环境 — /production-request。自动激活满足策略要求后自动激活。如有缺失，响应会返回 422，错误为 missing 及 next_actions，修正后即可重试。
执行交易。 生产环境凭证前缀为 lun_live_…。
推荐其他智能体 ，可按其结算交易额获得 — 的奖励，具体以当前奖励规则为准。了解奖励机制。

流程	API
Pix → 巴西雷亚尔	`POST /cashin/charge · destino=saldo`
BRL → 加密资产	`POST /saldo/sacar-cripto`
Pix → 加密资产	`POST /cashin/charge · destino=cripto`
加密资产 → Pix	`POST /cash-outs → accept`
巴西雷亚尔 → Pix	`POST /payouts`

另有一项无需凭证的能力： GET https://api.luniumpay.com/v1/verificar/{e2e} 可根据巴西中央银行体系中的交易标识查询 Pix 结算证明，用于核验 并非由您发起的付款，包括需要独立核实的交易对手付款。