luniumpay-com

luniumpay-com Mesh · Identity API

Cadastro de agente, credencial e ciclo de vida ate producao.

GitHub OpenAPI

Operations 4

POST /mesh/agents Cadastrar um agente e receber credencial de sandbox #
GET /mesh/agents/{agent_id} Estado, mandate, metricas e linhagem de um agente #
POST /mesh/agents/{agent_id}/validate Provar que o sandbox foi exercitado #
POST /mesh/agents/{agent_id}/production-request Ativar producao (automatico, sem humano) #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/luniumpay-com/openapi/luniumpay-com-mesh-identity-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/luniumpay-com/json-schema/luniumpay-com-cash-out-schema.json
📊
JSONSchema
https://artifacts.apis.io/luniumpay-com/json-schema/luniumpay-com-status-cobranca-schema.json
📊
JSONSchema
https://artifacts.apis.io/luniumpay-com/json-schema/luniumpay-com-chave-me-schema.json
📊
JSONSchema
https://artifacts.apis.io/luniumpay-com/json-schema/luniumpay-com-cobranca-schema.json
📊
JSONSchema
https://artifacts.apis.io/luniumpay-com/json-schema/luniumpay-com-payout-schema.json
📊
JSONSchema
https://artifacts.apis.io/luniumpay-com/json-schema/luniumpay-com-catalogo-compra-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/luniumpay-com:luniumpay-com-mesh-identity-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

luniumpay-com-mesh-identity-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Luniumpay Com Mesh · Identity 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 · Identity 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 · Identity
  description: Cadastro de agente, credencial e ciclo de vida ate producao.
paths:
  /mesh/agents:
    post:
      tags:
      - Mesh · Identity
      operationId: meshRegisterAgent
      summary: Cadastrar um agente e receber credencial de sandbox
      description: Cadastro e emissao de chave numa chamada. Com `referral_token`, a linhagem fica provada; sem ele, o agente entra como raiz.
      security: []
      x-lunium-agent-safe: true
      x-lunium-environment: sandbox
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentRegistration'
      responses:
        '201':
          description: Agente criado, com credencial e proximo passo.
          content:
            application/json:
              schema:
                type: object
                properties:
                  agent:
                    $ref: '#/components/schemas/AgentIdentity'
                  api_key:
                    type: string
                  sandbox:
                    type: boolean
                  lineage:
                    type: object
                  proximo_passo:
                    type: object
        '400':
          description: Pedido invalido ou referral_token recusado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErroAutocorrigivel'
    servers:
    - url: https://api.luniumpay.com
      description: Produção
  /mesh/agents/{agent_id}:
    get:
      tags:
      - Mesh · Identity
      operationId: meshGetAgent
      summary: Estado, mandate, metricas e linhagem de um agente
      security: []
      x-lunium-agent-safe: true
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
        example: agt_2319c9da313e84af3b
      responses:
        '200':
          description: O agente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentIdentity'
        '404':
          description: Nao existe.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErroAutocorrigivel'
    servers:
    - url: https://api.luniumpay.com
      description: Produção
  /mesh/agents/{agent_id}/validate:
    post:
      tags:
      - Mesh · Identity
      operationId: meshValidateAgent
      summary: Provar que o sandbox foi exercitado
      description: 'Recusa quem so criou a chave: e preciso ter criado E aceito uma ordem no sandbox. E o passo que garante que o seu tratamento de erro e o seu polling existem antes de haver dinheiro envolvido.'
      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'
    servers:
    - url: https://api.luniumpay.com
      description: Produção
  /mesh/agents/{agent_id}/production-request:
    post:
      tags:
      - Mesh · Identity
      operationId: meshActivateProduction
      summary: Ativar producao (automatico, sem humano)
      description: 'Confere sozinho: validacao com prova de uso, endereco de liquidacao em rede suportada, mandate dentro da politica e credencial ativa. Passando, producao entra na mesma resposta. Faltando algo, devolve 422 com `missing` e `next_actions` para o agente corrigir e tentar de novo.'
      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:
                $ref: '#/components/schemas/ProductionActivation'
        '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'
        '422':
          description: Requisitos incompletos — legivel por maquina.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErroAutocorrigivel'
      x-lunium-settlement-required: true
    servers:
    - url: https://api.luniumpay.com
      description: Produção
components:
  schemas:
    AgentLifecycle:
      type: string
      enum:
      - registered
      - sandbox_active
      - validated
      - production_active
      - suspended
      description: 'Producao e ativada por POLITICA, sem humano no circuito. Nao existe estado de espera por aprovacao: o controle de risco esta na regua por PAGADOR (cash-in), no teto por operacao, no teto diario de quem recebe o PIX (venda) e no mandate da propria chave — nao existe teto diario por chave de API (desde 10/09/2026), nem fila de aprovacao.'
    ProductionActivation:
      type: object
      description: Ativacao AUTOMATICA. `activated_by` e sempre `policy` — nunca `operator`.
      properties:
        status:
          type: string
          example: production_active
        agent_id:
          type: string
        environment:
          type: string
          example: production
        activated_at:
          type: string
          format: date-time
        activated_by:
          type: string
          example: policy
        api_key:
          type: string
          description: Credencial de producao (`lun_live_*`), uma vez so.
        settlement:
          type: object
        mandate:
          $ref: '#/components/schemas/Mandate'
        capabilities:
          type: array
          items:
            type: string
    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
    AgentRegistration:
      type: object
      required:
      - name
      properties:
        name:
          type: string
          minLength: 2
          maxLength: 80
        description:
          type: string
        contact:
          type: string
        agent_card_url:
          type: string
        capabilities:
          type: array
          items:
            type: string
        referral_token:
          type: string
          description: 'Attestation assinada por quem indicou. E o UNICO jeito de ter linhagem: `referred_by` declarado pelo cliente e recusado, porque vale dinheiro.'
    AgentIdentity:
      type: object
      description: Identidade PERMANENTE do agente. Credencial e substituivel; linhagem, volume, recompensa, mandate e reputacao pertencem ao agent_id.
      properties:
        agent_id:
          type: string
          example: agt_2319c9da313e84af3b
        name:
          type: string
        description:
          type:
          - string
          - 'null'
        contact:
          type:
          - string
          - 'null'
        status:
          $ref: '#/components/schemas/AgentLifecycle'
        environment:
          type: string
          enum:
          - sandbox
          - production
        capabilities:
          type: array
          items:
            type: string
        settlement_address:
          type:
          - string
          - 'null'
        referred_by:
          type:
          - string
          - 'null'
          description: Imutavel apos o registro (gatilho no banco).
        created_at:
          type: string
          format: date-time
    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.
    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