Lunium. docs

You are an agent. This is everything you need.

Autonomous runbook: sandbox to production

Methods, exact prerequisites, credentials, callbacks and recovery. Mesh activates production automatically by policy; ordinary key provisioning supports custody without a fixed wallet.

Open complete runbook · JSON · Markdown

Lunium Partners

Official integrator community for operational notices, maintenance, API changes and partner discussions. Participation is strongly recommended from the beginning of integration.

Join Lunium PartnersParticipation guide

Operations and reconciliation

Configure commission, understand fees, recover monitor access and handle incidents using the current contract.

Fees and commissionRecover accessIncident runbook

Lunium settles between Brazilian PIX and stablecoins. An agent discovers, integrates, validates, reaches production and transacts automatically within the owner’s mandate and API policy. This page is the whole path.

start here

One call, no key:

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

It answers who we are, what we settle, which assets and networks, every endpoint, how to get a credential, how to reach production, the limits and the schemas. — capabilities and — indexed intents.

The path, from zero to a real transaction

  1. Discovery. Start from the domain: https://luniumpay.com answers, in its Link header, where /.well-known/api-catalog lives (RFC 9727). From there you reach /mesh without knowing any path. How it works.
  2. Pick the capability by your intent, not by our vocabulary. Each capability declares intent, input_assets, output_currencies and payment_rails. Filter by attribute.
  3. Register at POST /mesh/agents. You get an agent_id and a lun_test_… credential in the same response.
  4. Exercise the sandbox. Holding a key is not enough: create and accept an order. That is what proves your error handling exists before real money does.
  5. Validate at POST /mesh/agents/{id}/validate.
  6. Say where to receive — /settlement.
  7. Set your mandate — /mandate. It only tightens your own limits, never widens them. Why.
  8. Activate production — /production-request. automatic No person decides. If something is missing you get 422 with missing and next_actions, fix it and retry.
  9. Transact. The production credential is lun_live_….
  10. Bring another agent and earn — of the volume it settles. How the economy works.

What Lunium does

FlowAPI
Pix → BRLPOST /cashin/charge · destino=saldo
BRL → criptoPOST /saldo/sacar-cripto
Pix → criptoPOST /cashin/charge · destino=cripto
Cripto → PixPOST /cash-outs → accept
BRL → PixPOST /payouts
One thing needs no credential at all: GET https://api.luniumpay.com/v1/verificar/{e2e} proves a PIX payment really settled, from its Central Bank identifier. Use it to check a payment you did not make, from a counterparty you have no reason to trust.
MeshDiscoveryCapabilitiesOnboardingMandatesSettlementProductionReferralsEconomySecurityErrorsExamples

Human support and live tracking

Human support group strongly recommended: Lunium or the partner can create the project group and add @luniumb2b and @luniumb2c, alongside @LuniumNotifyBot. Read the group setup guide. Use the private monitor from /keys/me and implement webhooks, live tracking and reconciliation. Never expose credentials, secrets or the monitor to unauthorized users.