01 — Infraestrutura PIX ↔ stablecoin

PIX Stablecoins.
Uma API.

Conecte pagamentos brasileiros à economia global de stablecoins.

Receba PIX e liquide em USDT ou USDC.
Receba stablecoins e liquide via PIX.

Uma única API para cash-in, cash-out e payouts.

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
o mesmo ciclo que sua aplicação acompanha pela API — por GET ou por webhook
02 — Produto

O dinheiro anda nos dois sentidos.

A Lunium conecta PIX e stablecoins em uma única infraestrutura programável.

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

Hoje, o cash-in é liquidado na Polygon.

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 →
03 — 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 API.

POST /keys
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.

04 — 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.

05 — 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 na hora

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

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.

06 — 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.

07 — 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.

08 — 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.

09 — 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
10 — Operação

Sua operação. Ao vivo.

Toda chave de API inclui acesso a um monitor operacional restrito à sua conta.

  • 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
monitor · escopo: sua chave · somente leitura
cashin.paidR$ ••••,00processando
cashin.settled•• USDT · polygonliquidado ✓
cashout.completedR$ ••••,00 · PIXpago ✓
payout.sentR$ •••,00enviado ✓
webhookentrega assinada2xx ✓
11 — 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.

12 — Sandbox

Teste a falha antes que a falha teste você.

O sandbox de cash-out da Lunium usa a mesma estrutura de API e o mesmo ciclo de vida da produção. Cada cenário tem um gatilho determinístico — bom para CI, não só para curiosidade.

Transação bem-sucedidao caminho feliz, com o ritmo real
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, sem cadastro.

13 — Soluções

Para quem constrói produto financeiro.

Fintechs

Adicione liquidação PIX e stablecoin à sua aplicação sem construir o pipeline de pagamento inteiro.

Plataformas cripto

Conecte pagamentos brasileiros à infraestrutura de stablecoins com uma API.

Carteiras

Dê aos usuários um trilho de entrada e saída entre PIX e dólares digitais.

Marketplaces

Automatize recebimentos, liquidação e payouts.

Negócios globais

Conecte fluxos de pagamento brasileiros à liquidação em stablecoin.

Plataformas B2B

Embuta a Lunium dentro do seu produto e automatize transações programaticamente.

14 — 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.

15 — Documentação

Não acredite na gente.
Leia a API.

22 operações documentadas
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
16 — 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.

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

Conecte o PIX às stablecoins.

Uma API para os fluxos de pagamento que o seu produto exige.

Cash-in · Cash-out · Payouts