Lunium。 文档

注册接入

五个状态,均无需等待人工审批。

registered → sandbox_active → validated → production_active → suspended

生产环境按规则激活

POST /mesh/agents/{id}/production-request 会自动核对并启用:

全部通过后,在同一响应激活生产;缺少条件时,返回 422,错误为 missing 及 next_actions ,列明修正所需的精确方法及接口,无需猜测自由文本。

自动激活不代表无限额。 Lunium 不设置 API 密钥每日总额度,但仍适用单笔范围、cash-in 付款人动态规则、cash-out 收款人每日 R$ 100,000.00 上限、对外付款可用余额,以及密钥自身配置的 mandate 。实际数值见 GET /keys/me 及 GET /cashin/limits?payer_tax=…。

身份与凭证是不同概念

内容
agent_id永久身份,推荐关系、交易量、mandate、奖励及信誉均归属该身份。
lun_test_…测试凭证,不移动真实资金。
lun_live_…生产凭证,可替换;轮换不会丢失余额或推荐关系。

2026年8月29日前签发的密钥以 lun_ 开头,仍有效。认证依据哈希,不依据前缀。

Mesh服务发现能力目录注册接入Mandate 授权策略结算生产环境推荐关系奖励规则安全机制错误处理示例