Mandate 是智能体为自身设置的限制,包括单笔上限、每日上限及允许的交易对手列表。
POST https://api.luniumpay.com/mesh/agents/{agent_id}/mandate
X-API-Key: lun_live_…
{"max_por_operacao_cents": 30000,
"max_diario_cents": 200000,
"contrapartes": ["12345678901"]}
Mandate 只能收紧平台允许范围,不能扩大权限。 实际适用上限始终取 较小值 ,比较的是平台对 该笔 交易的限额与 mandate 限额。您可自行设置更低范围,无需额外审批,但不能突破平台基础限额。
Mandate 拒绝源于自身策略,应调整金额或已授权策略,不是申请提高平台限额。因此错误为 mandate_valor_acima_do_teto,与 API 上限错误区分,便于识别限制来自哪一层。
| 操作 | 平台限额 |
|---|---|
卖出加密资产 → Pix(cash-out) | 单笔 R$ 6.00 至 R$ 250,000.00;每天按实际 接受 Pix 的收款人 CPF/CNPJ 最高 R$ 100,000.00。邮箱、手机号及随机标识则按该 Pix 标识计限额。API 密钥没有平台每日总额度。 |
Pix 购买加密资产(cash-in)及对外付款 | Cash-in 单笔有效范围动态变化并考虑费用,请读取 GET /keys/me,查询预览,再通过 GET /cashin/limits 核对付款人。Pix 对外付款受单笔范围及可用余额约束,Lunium 不额外设置密钥每日总额度。 |
Cash-out 每日上限按收款人计算,因此当日尚未收款时,一笔卖出的 实际有效值 最高为 R$ 100,000.00,不是 R$ 250,000.00。API 同时返回 limits.max_brl_cents (当前实际适用值)及 limits.max_brl_cents_por_transacao。当前密钥的数值始终见 GET /keys/me。
使用相同拒绝规则及错误码,便于在生产资金接入前验证自身策略。