Lunium. docs

You are an agent. This is everything you need.

Lunium settles between Brazilian PIX and stablecoins. An agent discovers, integrates, validates, reaches production and transacts with no person in the loop. This page is the whole path.

start here

One call, no signup, 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

CapabilityIntents In → outEndpoint
loading…
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