Infraestrutura para o seu próximo produto

Pix no seu produto.
Liberdade no
próximo passo.

Receba Pix e entregue USDT na carteira escolhida. Ou envie cripto para pagar um Pix, com acompanhamento e comprovante. Você também pode manter saldo em reais e integrar esses fluxos ao seu software.

Teste sem dinheiro real Sem carteira fixa para receber em custódia

Prefere conversar? Atendimento humano no WhatsApp ↗

LUNIUMVISÃO ILUSTRATIVA DO PRODUTO
Do pagamento ao próximo destinoConecte as possibilidades.
PixSaldo BRLUSDTUSDC+ catálogo
cash-in · ci_9f2e…
◎
PIX recebido
evento: cashin.paid
R$ 5.000,00
⇄
Convertendo
BRL → USDT
5,1047
Liquidação
USDT → Polygon
0x8ef1…
✓
Concluído
evento: cashin.settled · tx confirmada on-chain
979,49 USDT
Exemplo ilustrativo · estados por API e webhook
Webhooks assinados. Cada etapa acompanhada.
Do que você precisa agora?

Seu próximo pagamento,
em dois caminhos.

Veja como funciona, prepare o fluxo com sua IA e comece pelo teste. Para operar, conecte sua conta e confira as condições antes de confirmar.

Receber

Receba Pix em USDT

Informe o valor, os dados do pagador e a carteira de destino. Gere o QR, acompanhe o Pix e o envio de USDT pela rede escolhida.

Veja a estimativa líquida, as taxas e eventuais retenções antes de criar a cobrança.

Pagar

Pague Pix com cripto

Informe uma chave e o valor, ou o copia e cola. Confira a cotação, envie a cripto conforme as instruções e acompanhe até o comprovante disponível.

Moedas e redes seguem o catálogo. Copia e cola aceita USDT/USDC em rotas compatíveis.

Use Gemini, ChatGPT ou sua IA para entender e preparar a integração. A execução de pagamentos pelo chat exige ferramentas conectadas à sua conta. Ver formas de conexão.

Produto

Um ponto de partida.
Todos os seus fluxos.

Recebimentos, saldos e saídas conectados pela mesma API. Escolha o caminho que faz sentido para o seu produto.

Custódia BRL

Receba Pix.
Escolha a saída.

Receba o líquido na custódia em reais, organize o saldo por cliente e escolha depois quando pagar ou sacar.

Pixsaldo BRLPix ou cripto

Sem carteira fixa na entrada. A rede e o endereço são escolhidos no saque cripto.

Explorar a custódia →
Cash-in

PIX → USDT / USDC

Seu cliente paga um PIX comum. A Lunium identifica o pagamento, faz a conversão e liquida a stablecoin diretamente no endereço configurado.

PIXpagamento detectadoconversãoliquidaçãoUSDT / USDC

Ativos, redes, mínimos e estimativas disponíveis no catálogo da API.

Explorar o cash-in →
Cash-out

Stablecoins → PIX

Envie USDT ou USDC. Receba uma cotação, confirme a operação, deposite a stablecoin — e a Lunium executa a liquidação via PIX.

USDT / USDCcotaçãoaceitedepósitoconfirmaçãoPIX

Disponível em múltiplas redes, pelo catálogo da API.

Explorar o cash-out →
Payouts

Payouts em PIX, via API

Envie PIX diretamente do seu sistema pela infraestrutura da Lunium. Crie pagamentos, acompanhe o status e concilie cada operação pela API.

POST /payoutsprocessingsent

Sem cripto no meio: reais, direto na chave PIX.

Explorar payouts →
Receba agora. Decida depois.

O Pix chega.
O próximo passo
é seu.

O recebimento pode ficar na custódia em reais. Organize saldos por cliente e escolha como movimentar o disponível, sem definir uma carteira cripto na entrada.

Conhecer a custódia BRL

Moedas, redes, taxas e limites são consultados na API antes da operação.

ENTRADASeu cliente paga com Pix
Custódia em reaisUm saldo.
Mais possibilidades.
PixPagamentos e saques
CriptoEscolha ativo e rede

Fluxo ilustrativo · movimentação do saldo disponível

Lunium Partners

Sua conta. Do sandbox à produção.

Crie sua conta, entre no painel de parceiros e teste sua integração. Quando estiver pronto, gere a chave de produção na mesma conta.

1 · Sandbox

Comece pelo sandbox

Gere sua chave de teste no painel e valide Pix, saldos e webhooks com dinheiro fictício.

2 · Produção

Avance para produção

Complete os dados do negócio e gere sua chave de produção. As credenciais e operações ficam separadas do sandbox.

Developers

Integre sem esperar pela gente.

A infraestrutura foi construída para developers começarem pela API — e não por uma reunião comercial.

01

Crie sua chave de teste.

POST /keys/sandbox
02

Peça uma cotação.

POST /cashin/preview
03

Crie uma cobrança PIX.

POST /cashin/charge
04

Receba a liquidação.

cashin.settled

Sem provisionamento manual de credencial. Sem esperar alguém criar a sua primeira chave.

Taxas

Taxa por parceiro, que cai com o volume.

Integração padrão: 2% + R$ 2,00 por operação. Parceiros de volume negociam a taxa, chegando a 35 bps sobre a cotação de referência de mercado do USDT para parceiros exclusivos. Sem mensalidade: a taxa vigente da sua chave aparece em GET /keys/me e toda cotação já vem líquida.

Código

Do PIX à stablecoin em uma integração.

requestnode
const response = await fetch(
  "https://api.luniumpay.com/cashin/charge",
  {
    method: "POST",
    headers: {
      "X-API-Key": process.env.LUNIUM_API_KEY,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      amount_cents: 25000,
      payer_tax_number: "12345678901",
      payout_address: "0x…",
      asset: "usdt",
      external_id: "order_8812"
    })
  }
);

const charge = await response.json();
response200
{
  "cashin_id": "ci_b3f9d2a41c6e…",
  "status": "pending",
  "amount_cents": 25000,
  "chain": "polygon",
  "asset": "usdt",
  "qr_copypaste": "00020126…",
  "qr_image_url": "https://…",
  "external_id": "order_8812",
  "expires_at": "2026-…"
}

Sua aplicação recebe o PIX. A Lunium cuida do resto do caminho.

Integração por software

Construa com seu time.
Ou com a IA que você usa.

Do ChatGPT ao Fable, dê à sua IA o contexto da API e um caminho de integração. Sua equipe também pode começar diretamente pelo código.

01

Integração por developer

API REST direta, OpenAPI 3.1, sandbox determinístico e produção. Nada mudou: se você já integra, continua exatamente igual.

Começar a construir
02

Integração por agente

Descoberta por padrão aberto, catálogo de capacidades legível por máquina, política de gastos definida pelo próprio integrador e entrada em produção por regra.

Lunium para agentes

Sandbox, OpenAPI e MCP. Descoberta, implementação, testes e passagem para produção, conforme as autorizações e os requisitos da API.

Operação

Cada evento.
Uma visão da operação.

Acompanhe a operação no painel do parceiro e no monitor restrito à sua conta. Integre um acompanhamento ao vivo ao seu produto com os webhooks e a consulta de status.

  • Cash-in, cash-out e payouts
  • Status e liquidações
  • Eventos operacionais em tempo real
  • Sem expor o seu segredo de API — o monitor tem token próprio, somente leitura, e rotacionável
  • Confirme o recebimento e o tratamento dos webhooks no seu backend
monitor · escopo: sua chave · somente leitura
cashin.paidR$ ••••,00processando
cashin.settled•• USDT · polygonliquidado ✓
cashout.completedR$ ••••,00 · PIXpago ✓
payout.sentR$ •••,00enviado ✓
webhookentrega assinada2xx ✓
Lunium Partners

Você constrói.
A gente está por perto.

Entre na comunidade oficial para acompanhar novidades, avisos operacionais e trocar experiências com outros integradores.

Entrar no Lunium Partners
Pessoas de verdade, junto do seu projeto

Seu grupo de integração.

Recomendamos um grupo dedicado, criado pela Lunium ou pela sua equipe, com os agentes humanos @luniumb2b e @luniumb2c. O bot e o monitor complementam esse acompanhamento.

Falar com uma pessoa no WhatsAppIntegração · operação · dúvidas comerciais
Soluções para o seu negócio

Pix e stablecoins,
no fluxo do seu negócio.

Da venda online ao pagamento de fornecedores, encontre a aplicação da Lunium para a sua operação.

A profundidade também importa

Uma API que você
pode conhecer por inteiro.

Explore os detalhes da operação. Catálogos, taxas, estados, testes e recuperação de falhas, organizados para você e sua equipe.

01Projetada para produção
Produção

Feita para developers.
Desenhada para produção.

OpenAPI 3.1

Especificação legível por máquina

Sincronizada com a API de produção — e auditada contra ela.

Postman & Insomnia

Importe e teste em minutos

Importe a especificação da API e comece a testar em seguida.

Webhooks

Webhooks assinados

Verifique a autenticidade de cada evento com assinatura criptográfica.

Idempotência

Idempotência nativa

Repita operações com segurança, sem criar transações financeiras duplicadas.

Erros

Erros estruturados

Construa tratamento de erro previsível, em vez de interpretar mensagens de texto.

Catálogo

Catálogo dinâmico

Descubra ativos e redes disponíveis programaticamente, sem fixar nada no código.

Conciliação

Conciliação

Use as respostas da API e os identificadores de liquidação como fonte de verdade financeira.

02Moedas, redes e catálogo
Redes

Cash-out nas redes que seus clientes já usam.

O catálogo da Lunium expõe os ativos e as redes disponíveis para cash-out — ao vivo, não numa tabela desatualizada.

USDT USDC
Polygon Ethereum BNB Chain Arbitrum Optimism Base Avalanche Aptos NEAR + as demais redes do catálogo — disponibilidade por ativo em GET /catalog
GET /catalog

A disponibilidade muda. Sua integração não precisa adivinhar — se está no catálogo, está disponível.

03Cotações e taxas antes de operar
Cotação

Primeiro a cotação.
Depois o dinheiro.

Infraestrutura financeira nunca deveria exigir que a sua aplicação adivinhe o valor final.

Antes de criar um cash-in
POST /cashin/preview

Cotação sem criar nada — já com a taxa da sua chave aplicada.

Para o cash-out
POST /cash-outs

Cotação com validade explícita. Nada acontece até você aceitar.

A API devolve os valores usados pela transação.
O seu sistema exibe a cotação. A Lunium permanece a fonte de verdade.

04Estados de cada transação
Ciclo de vida

Toda transação tem um ciclo de vida.

Cash-in
pendingpaidsettled ✓ouexpired

Estados reais do contrato: o PIX chega a paid; a entrega on-chain é o settlement_status (pending → sending → sent) e o evento cashin.settled avisa a hora de creditar.

Cash-out
QUOTE_CREATEDAWAITING_DEPOSITDEPOSIT_DETECTEDcashout.processingCOMPLETED ✓

Os estados internos de conversão colapsam num único evento cashout.processing — você não precisa tratar cada um.

Sua aplicação acompanha o estado pela API — e recebe cada transição por webhook.

05Idempotência e recuperação de falhas
Idempotência

Feita para retry não virar pagamento em dobro.

APIs financeiras falham diferente de APIs comuns.

Conexões caem. Servidores reiniciam. Respostas dão timeout.
E a sua aplicação repete a chamada.

O modelo de idempotência da Lunium permite que o mesmo external_id referencie com segurança a mesma operação financeira — inclusive para recuperá-la depois de um erro ambíguo.

Mesma operação Mesmo identificador Nenhuma transação duplicada
06Bot e operação pelo Telegram
Operação humana

API para o seu software.
Agente para o seu time.

Sua aplicação
api.luniumpay.com

Opera pela API da Lunium: cria, acompanha, concilia — programaticamente.

Seu time
  • Pergunte sobre a sua integração
  • Receba alertas de transação em tempo real
  • Abra o monitor ao vivo
  • Consulte a atividade operacional

API para máquinas. Agente para humanos.

07Sandbox: cenários de sucesso e falha
Sandbox

Teste a falha antes que a falha teste você.

Teste recebimento Pix, custódia em reais, saque cripto, payout Pix e transferência interna com saldo fictício. A sandbox reproduz os estados da integração sem pagar Pix ou movimentar cripto real. No cash-out, os cenários abaixo ajudam a exercitar sucesso, atraso e falha.

Transação bem-sucedidao caminho de sucesso, com execução simulada
Transação atrasadagatilho .01 — delayed que vira paga sozinha
Transação que falhagatilho .02 — exercite seu caminho de erro
Cotação expiradagatilho .03 — prove que você recota
Erro de limitegatilho .04 — com o objeto limits preenchido
Conflito de idempotênciareuse um external_id e receba o 409 real
Assinatura de webhookPOST /webhooks/test valida o seu handler
POST /keys/sandbox

Crie uma credencial de teste sem mover fundos reais — uma chamada.

08Configuração e histórico pela API
Fonte de verdade

Quem diz o que a API faz é a própria API.

Não é deck de vendas. Não é PDF. É a API.

GET /keys/meConfiguração da conta, limites vigentes e elegibilidade — legíveis por máquina.
GET /catalogAtivos e redes disponíveis, agora.
GET /cashin/chargesHistórico de cash-in.
GET /cash-outsHistórico de cash-out.
GET /payoutsHistórico de payouts.

Sua integração lê a configuração vigente em vez de depender de suposições.

09O que conferir antes de integrar
Antes de comprar

Infraestrutura que você inspeciona antes de comprar.

A maioria das empresas de pagamento pede que você fale com vendas antes de entender o produto. A Lunium faz o caminho oposto.

  • 01Leia a documentação.
  • 02Inspecione os endpoints.
  • 03Crie uma chave de sandbox.
  • 04Entenda o ciclo de vida.
  • 05Teste a sua integração.

Depois, fale com a gente — quando precisar de limites de produção, condições comerciais ou suporte enterprise.

Documentação

Não acredite na gente.
Leia a API.

Operações documentadas no OpenAPI
OpenAPI 3.1
Schemas de request e response
Exemplos em cURL
Exemplos em Node.js
Exemplos em Python
Webhooks assinados documentados
Contratos de erro
Cenários de sandbox
Changelog
Status de produção

Seu próximo produto
começa com uma chave.

Comece no sandbox. Teste o fluxo. Leve sua integração para produção.

Pix · Custódia BRL · Cripto · Payouts

Soluções e guias para integrar Pix

Escolha o fluxo do seu produto ou veja a central de integração.

API Pix para empresasCobranças, QR Code, confirmação e pagamentos no seu sistema.Como escolher uma API PixCompare fornecedores, custos, testes e acompanhamento operacional.API Pix com custódiaReceba em reais sem carteira fixa. Separe saldo por cliente e saque em Pix ou cripto.Sandbox de pagamentosTeste os fluxos completos, falhas e webhooks com saldo fictício.API PIX para USDTReceba em reais e entregue USDT na carteira do cliente.API USDT para PIXVenda stablecoin e pague qualquer chave PIX.API de payout PIXPague fornecedores e usuários em reais, por API.BRL ↔ USDT por APIConversão nos dois sentidos, com cotação e comprovante.On-ramp e off-ramp no BrasilEntrada e saída de cripto no país, numa integração só.PIX no checkout, stablecoin no caixaReceba do cliente em PIX e guarde em dólar digital.PIX e stablecoin para walletsDê aos seus usuários um trilho de entrada e saída.Infraestrutura com a sua marcaO trilho inteiro operando por trás do seu produto.
Perguntas diretas

As dúvidas que chegam antes da primeira chamada.

Respostas curtas e verificáveis. O detalhamento completo está no FAQ e na documentacao.

Como receber PIX e liquidar em USDT?

Sua aplicacao chama POST /cashin/charge e recebe um QR code PIX (copia e cola) para mostrar ao pagador. Quando o PIX e liquidado, o valor e creditado em USDT ou USDC. O estado vem por GET /cashin/{id}/status e por webhook assinado.

Como aceitar stablecoin e pagar em PIX?

E o caminho inverso (cash-out): POST /cash-outs/preview cota; POST /cash-outs cria a ordem; POST /cash-outs/{id}/accept devolve o endereco de deposito. Confirmado o deposito em USDT ou USDC, o PIX sai para a chave informada.

Preciso de cadastro para testar a API?

No painel, crie uma conta para organizar suas chaves de sandbox e produção. O acesso direto pela API continua disponível: POST /keys/sandbox com seu e-mail cria uma chave de teste em uma chamada, sem conta no painel. Agentes de IA continuam pelo Mesh ou MCP. Ela simula Pix para custódia ou cripto, saques em Pix e cripto, transferências internas e cripto para Pix. Inclui estados, falhas e webhooks. O saldo é fictício e o QR não é pagável; pagamentos reais exigem produção. O e-mail é obrigatório porque é para ele que mandamos o manual, o fluxograma e o passo a passo da integração.

Quais moedas e redes sao suportadas?

Consulte GET /cashin/catalog para receber cripto após um Pix e GET /catalog para depositar cripto e receber Pix. USDT, USDC e outros ativos dependem do fluxo, da rede e da disponibilidade vigente. Os catálogos dos dois sentidos são diferentes; confirme a rota antes de oferecer o pagamento.

Para quais chaves PIX a API consegue pagar?

Qualquer chave: CPF, CNPJ, telefone, e-mail ou chave aleatoria. A API valida o formato. A consulta auxiliar de titular pode estar indisponível; confira o resultado retornado e os dados do destinatário.

Da para conferir um pagamento sem ter conta?

Sim. GET /v1/verificar/{e2e} e uma rota aberta: com o identificador ponta a ponta do PIX, qualquer pessoa confere se aquele pagamento foi liquidado, sem chave de acesso.

Quanto custa?

Nao ha mensalidade: a cobranca e por operacao. A taxa vigente da sua chave vem em GET /keys/me, e a cotacao ja mostra o valor liquido. O detalhamento esta em luniumpay.com/faq.

Quem opera a Lunium?

ZANQUETA INTERMED LTDA, CNPJ 68.538.127/0001-00, com sede em Americana/SP. Contato: contato@luniumpay.com.

Fale com nossa equipe

A chave de teste sai em uma chamada, sem aprovação prévia — se é isso que você quer, comece pela documentação. Este formulário é para o resto: taxa por volume, um caso que a doc não cobre, ou uma dúvida antes de integrar.

Prefere e-mail direto? contato@luniumpay.com