Lunium for AI agents

From discovery to production.
With the AI you use.

Your agent can discover the API, implement the flow and test it in the sandbox. With authorization and the requirements met, it can activate production through the API, using direct onboarding or Lunium Mesh according to the flow.

Prepare my integration Explore the API

Start with simulated funds. Production credentials belong in your backend.

From intent to integrationFlow illustration

Your ideaI want to collect Pix and let my customer choose when to withdraw.

LuniumPayAPI · rules · tracking

01Collect PixCreate a charge

02BRL balanceBRL custody

03Choose withdrawalPix or crypto

Choose a wallet when withdrawing crypto. No fixed address needed for custody deposits.

OpenAPI for your AIIntegration MCPSandbox scenariosHuman project support

01 / Choose what to build

One flow. One prompt.
A clear place to start.

Use it in Fable or the AI writing your project. The prompt includes the contract, tests and operational checks.

Your integration brief

Build a LuniumPay integration for my project. Goal: Collect Pix into BRL custody without a fixed wallet, then let the customer choose a crypto withdrawal.

Read https://docs.luniumpay.com/integration.json and the OpenAPI it references. Start in sandbox; use the current schemas and starter kit.

Keep credentials in the backend. Implement persistent external_id, signed webhooks and status reconciliation. Read route-specific fees, minima and availability from the API. Test success, holds, failures and lost responses.

Show me the implementation and test results. Do not move real funds or change fees without authorization. Include the Lunium Partners community and human project support in the go-live plan.

Follow https://docs.luniumpay.com/agent-onboarding.json. Choose between Mesh (sandbox proof, Polygon address, mandate and automatic activation) and ordinary custody registration without a fixed wallet. Complete preparation and activate production through the applicable track when covered by my authorization. Do not stop at a demo: configure the live key and webhook separately, test reconciliation and present evidence. Ask only for still-missing information or authorization; respect the existing mandate.

What you will build

Collect Pix into balance

Collect Pix into BRL custody without a fixed wallet, then let the customer choose a crypto withdrawal.

Sandbox first, with verifiable results
Original IDs preserved on retries
Live tracking and human support

Test this flow →Read the guide →

Tests use fictitious funds. No real Pix payment, exchange withdrawal or blockchain transfer.

02 / From testing to operations

The integration moves forward.
From sandbox to production.

Start with the right context

Paste the prompt into your AI. It can find current fields, examples and conditions in the API contract.

Open the contract →

Test the complete flow

Validate success, holds, failures and lost responses. Check states and webhooks before connecting production.

Explore the sandbox →

Activate production through the API.

Your agent can use direct onboarding or Mesh according to the flow. With authorization and the requirements met, complete activation through the applicable path and validate credentials, permissions and events before the first live operation.

Activation runbook →

Autonomous integration / Lunium Mesh

The next step comes
in the API response.

Registration, sandbox proof and policy-based activation. Missing prerequisites include actionable next steps so the agent can continue.

Discover and implement

A structured runbook connects OpenAPI, four payment flows, examples and error recovery.

Test and validate

Mesh issues a sandbox key. The agent creates and accepts a simulated cash-out with that key and tests your product’s actual flow.

Activate and observe

With settlement and mandate configured, eligible production access activates automatically. The agent configures callbacks and tracks real operation states.

Read the complete path ↗JSON runbook for my AI

Mesh activation requires a Polygon address. A separate self-service API track supports BRL custody without a fixed wallet. The runbook explains both.

03 / Connect your tools

An API for developers.
Context ready for agents.

Use the public MCP in a compatible client to discover the API, prepare an integration and test simulated flows. For a coding agent, start with the prompt and starter kit.

Public integration MCP

https://api.luniumpay.com/mcp/onboarding

This connection does not provide access to your production account. Available tools are discovered by your MCP client.

API manualFlows, fees, commission and access recovery.Integration starter kitNode.js, Python, cURL and AI instructions.Context for your AIOpenAPI, steps and capabilities in structured form.Live operationsWebhooks, private monitor and state reconciliation.

Build with a team behind you

Join Lunium Partners.

The official community connects integrators with operational notices and API changes. Your technical team is strongly encouraged to join.

Join the community ↗

A group for your project

Lunium or your team can create a group and add @luniumb2b, @luniumb2c and the tracking bot.Arrange human support →Project cases and data belong in the dedicated group. The community does not replace the private monitor.

Let’s build together

Your idea deserves
a solid integration.

Tell us what you are building and where you need help. A new product, a migration or your first integration built with AI.

Find the right flow for your product
Discuss fees, volume and operations
Support your integration team

contato@luniumpay.com ↗

Ready to test? The sandbox is available without filling in this form. Get started →

Before you start.

Can an AI integrate and activate production autonomously?

Yes, with access to the code and execution tools and the business owner’s authorization. Mesh automatically activates eligible production access after registration, sandbox proof, Polygon settlement and monetary mandate. Provisioning does not authorize transfers beyond that scope.

Technical guide →

How should I choose a Pix API for an AI-built project?

Compare accessible contracts, API registration, failure tests, documented activation, idempotency, signed webhooks, queryable fees and operational tracking. Lunium publishes these entry points so an agent can evaluate the required flow and implement it with evidence. The right choice depends on the product, volume and operational requirements.

Technical guide →

Can I use Fable, ChatGPT or another AI?

Take the prompt to an AI that can read documentation or work on your code. If your client supports MCP, use the public integration URL. Features and permissions vary by tool.

Do I need a wallet to collect Pix?

Not for custody deposits. Send destino=saldo to receive a BRL balance. Choose asset, network and address when requesting a crypto withdrawal, subject to available balance and route rules.

Does the sandbox move real money?

No. It simulates flows, states and notifications. Do not pay the test QR or send crypto. A successful test does not certify production prices, liquidity or timing.

How do I track each transaction?

Use the private monitor and implement signed webhooks with status queries and backend reconciliation. Pix payment, available balance and crypto delivery are separate stages.

How do fees and partner commission work?

Read current conditions from the API. Partner commission is recorded separately from customer custody. See the manual for the breakdown, ledger and withdrawal policy; a preview does not guarantee future FX.

What about Mesh discovery and referrals?

Mesh publishes capabilities, registration, policies and network rules. Referral rewards depend on current rules and eligible settled activity. They differ from commercial partner commission. Read /mesh and /mesh/economy.

Mesh ↗Mesh economy ↗Commission guide ↗

From discovery to production.With the AI you use.

One flow. One prompt.A clear place to start.