Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Luniumpay Com Mesh · Policy API
version: 1.48.0
contact:
name: Lunium
email: contato@luniumpay.com
url: https://luniumpay.com/integrar?utm_source=openapi&utm_medium=spec
x-documentation-revision: 2026-09-17.4
x-lunium-partners:
name: Lunium Partners — comunidade oficial de integradores
url: https://t.me/+FerOZMRRP_g5MDk5
description: Avisos operacionais, mudanças de contrato e troca entre parceiros. Nunca publique uma chave de API no grupo.
description: 'Operations tagged Mesh · Policy across 2 of this provider''s published API definitions: api.json, luniumpay-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.luniumpay.com
description: Produção
security:
- ApiKey: []
tags:
- name: Mesh · Policy
description: Mandate e configuracao de liquidacao do proprio agente.
paths:
/mesh/agents/{agent_id}/settlement:
post:
tags:
- Mesh · Policy
operationId: meshSetSettlement
summary: Dizer para onde o dinheiro vai
description: Endereco na rede de liquidacao suportada.
parameters:
- name: agent_id
in: path
required: true
schema:
type: string
example: agt_2319c9da313e84af3b
x-lunium-agent-safe: true
responses:
'200':
description: Feito.
content:
application/json:
schema:
type: object
'401':
description: Sem chave.
content:
application/json:
schema:
$ref: '#/components/schemas/ErroAutocorrigivel'
'403':
description: A chave nao e deste agente.
content:
application/json:
schema:
$ref: '#/components/schemas/ErroAutocorrigivel'
'409':
description: Pre-requisito faltando.
content:
application/json:
schema:
$ref: '#/components/schemas/ErroAutocorrigivel'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SettlementConfiguration'
servers:
- url: https://api.luniumpay.com
description: Produção
/mesh/agents/{agent_id}/mandate:
post:
tags:
- Mesh · Policy
operationId: meshSetMandate
summary: Definir a propria politica de limites
description: So APERTA os limites da chave, nunca amplia. Obrigatorio antes de producao.
parameters:
- name: agent_id
in: path
required: true
schema:
type: string
example: agt_2319c9da313e84af3b
x-lunium-agent-safe: true
responses:
'200':
description: Feito.
content:
application/json:
schema:
type: object
'401':
description: Sem chave.
content:
application/json:
schema:
$ref: '#/components/schemas/ErroAutocorrigivel'
'403':
description: A chave nao e deste agente.
content:
application/json:
schema:
$ref: '#/components/schemas/ErroAutocorrigivel'
'409':
description: Pre-requisito faltando.
content:
application/json:
schema:
$ref: '#/components/schemas/ErroAutocorrigivel'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Mandate'
servers:
- url: https://api.luniumpay.com
description: Produção
components:
schemas:
Mandate:
type: object
description: 'Politica que a propria chave se impoe. So APERTA os limites, nunca amplia — por isso o agente pode defini-la sozinho: o pior que faz e se limitar. Obrigatorio antes de producao.'
properties:
max_por_operacao_cents:
type: integer
example: 30000
max_diario_cents:
type: integer
example: 200000
contrapartes:
type: array
items:
type: string
description: Chaves PIX autorizadas. Vazio = sem restricao.
NextAction:
type: object
description: O proximo passo, em forma de chamada. Um agente nunca deveria precisar interpretar texto humano para continuar.
properties:
method:
type: string
example: POST
endpoint:
type: string
example: /mesh/agents/{agent_id}/settlement
why:
type: string
example: sem rota de liquidacao o dinheiro nao tem para onde ir
SettlementConfiguration:
type: object
required:
- settlement_address
properties:
settlement_address:
type: string
example: 0x51e3…75e0
description: Carteira na rede de liquidacao suportada.
ErroAutocorrigivel:
type: object
description: 'Erro que o proprio agente consegue resolver. `acao` e enum estavel: corrigir (seu pedido esta errado), esperar (cota), parar (nao adianta repetir), repetir (falha transitoria nossa).'
properties:
erro:
type: string
example: mandate_valor_acima_do_teto
acao:
type: string
enum:
- corrigir
- esperar
- parar
- repetir
detail:
type: string
missing:
type: array
items:
type: string
next_actions:
type: array
items:
$ref: '#/components/schemas/NextAction'
required:
- erro
- acao
securitySchemes:
ApiKey:
type: apiKey
in: header
name: X-API-Key
description: Chave criada em `POST /keys`. Aparece uma única vez — guarde no momento da criação.
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Your key. `lun_test_…` is sandbox (moves nothing); `lun_…` is production.
externalDocs:
description: Mínimos e máximos por moeda e rede
url: https://docs.luniumpay.com/minimos
x-refined-from:
- api.json
- luniumpay-com-openapi.json