Lunium. docs

Você é um agente. Isto é tudo que precisa.

Roteiro autônomo: sandbox à produção

Métodos, requisitos exatos, credenciais, webhooks e recuperação. Mesh tem ativação automática por política; o cadastro comum permite custódia sem carteira fixa.

Abrir roteiro completo · JSON · Markdown

Lunium Partners

Comunidade oficial de integradores. Acompanhe avisos operacionais, manutenções, mudanças da API e a troca entre parceiros. A participação é fortemente recomendada desde o início da integração.

Entrar no Lunium PartnersComo participar

Operação e conciliação

Configure a comissão, entenda cada taxa, recupere o monitor e trate incidentes com o contrato vigente.

Taxas e comissõesRecuperar acessoResolver incidentes

A Lunium liquida entre PIX e stablecoins. Um agente descobre, integra, valida, entra em produção e transaciona automaticamente, dentro do mandato do responsável e das regras da API. Esta página é o caminho inteiro.

comece aqui

Uma chamada, sem chave nenhuma:

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

Ela responde quem somos, o que liquidamos, quais ativos e redes, todos os endpoints, como obter credencial, como chegar a produção, os limites e os schemas. — capacidades e — intenções indexadas.

O caminho, do zero à transação real

  1. Descoberta. Comece pelo domínio: https://luniumpay.com responde no cabeçalho Link onde está o /.well-known/api-catalog (RFC 9727). Dali você chega ao /mesh sem conhecer caminho nenhum. Como funciona.
  2. Escolha a capacidade pela sua intenção, não pelo nosso vocabulário. Cada capacidade declara intent, input_assets, output_currencies e payment_rails. Filtre por atributo.
  3. Cadastre-se em POST /mesh/agents. Recebe agent_id e uma credencial lun_test_… na mesma resposta.
  4. Exercite o sandbox. Não basta ter a chave: crie e aceite uma ordem. É o que garante que seu tratamento de erro existe antes de haver dinheiro.
  5. Valide em POST /mesh/agents/{id}/validate.
  6. Diga onde receber — /settlement.
  7. Defina seu mandate — /mandate. Ele só aperta seus próprios limites, nunca amplia. Por quê.
  8. Ative produção — /production-request. automático Nenhuma pessoa decide. Se faltar algo, você recebe 422 com missing e next_actions, corrige e tenta de novo.
  9. Transacione. A credencial de produção é lun_live_….
  10. Traga outro agente e receba — do volume que ele liquidar. Como funciona a economia.

O que a Lunium faz

FluxoAPI
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
Uma coisa só, sem credencial nenhuma: GET https://api.luniumpay.com/v1/verificar/{e2e} prova que um PIX liquidou de verdade, a partir do identificador do Banco Central. Serve para conferir pagamento que você não fez, de contraparte em quem você não tem motivo para confiar.
MeshDescobertaCapacidadesOnboardingMandatesLiquidaçãoProduçãoIndicaçãoEconomiaSegurançaErrosExemplos

Acompanhamento humano e ao vivo

Grupo humano fortemente recomendado: a Lunium ou o parceiro pode criar o grupo do projeto e adicionar @luniumb2b e @luniumb2c, além de @LuniumNotifyBot. Veja o roteiro do grupo. Para acompanhamento, use o monitor privado de /keys/me e implemente webhooks, painel ao vivo e conciliação. Não compartilhe chaves, segredos ou o monitor com pessoas não autorizadas.