LUNIUMPAY Documentação

Para wallets, fintechs e e-commerces

API Pix ↔ USDT para wallets, fintechs e e-commerces

Receba PIX e entregue stablecoin na carteira do seu cliente. Ou receba stablecoin e pague PIX para qualquer chave. Uma integração, os dois sentidos, com comprovante do Banco Central em toda operação.

Receber sandbox e falar com integração

O problema

Construir esse trilho leva meses. E depois alguém precisa mantê-lo.

Ligar PIX a stablecoin exige provedor de PIX, custódia de cripto, conciliação, tratamento de estorno, limite por pagador e comprovante que o cliente final aceite. Cada peça é um fornecedor, um contrato e um jeito diferente de falhar. A Lunium é esse trilho pronto, atrás de uma chave de API — e a sua equipe volta a construir o seu produto.

As três operações

Cash-in, cash-out e payout na mesma chave.

Cash-in

PIX vira cripto

Você cria a cobrança, o seu cliente paga o QR, e o USDT ou USDC cai na carteira que você indicar. O documento de quem paga é conferido antes de a cripto sair; se não bater, o PIX é devolvido e nada é entregue.

2% sobre o valor · sem taxa fixa

Cash-out

Cripto vira PIX

Você cota, deposita a stablecoin no endereço da ordem, e o PIX sai para qualquer chave — CPF, CNPJ, e-mail, telefone ou aleatória. Depois do depósito confirmado na Polygon, o PIX sai em cerca de 10 segundos, medido em produção.

Cotação já líquida · o valor mostrado é o que a chave recebe

Payout

PIX direto em reais

Sem cripto no meio. Para pagar fornecedor, entregador, criador, afiliado ou folha — um a um ou em lote, por API, com comprovante que o beneficiário confere sozinho.

1% + R$ 2,00 por envio

Sandbox

Uma chamada. Sem cadastro, sem aprovação, sem custo.

A chave de teste roda o fluxo inteiro — cotação, aceite, cobrança, status, comprovante — na mesma URL e nos mesmos endpoints da produção. Nada liquida: nenhuma cripto se move, nenhum PIX é pago.

# pegue a sua chave de teste
curl -X POST https://api.luniumpay.com/keys/sandbox \
  -d '{"name":"minha empresa"}'

# cobre R$ 50 e entregue USDT na Polygon
curl -X POST https://api.luniumpay.com/cashin/charge \
  -H 'X-API-Key: lun_test_…' \
  -d '{"amount_cents":5000,"asset":"usdt","chain":"polygon",
       "payout_address":"0x…","payer_tax_number":"CPF de quem paga"}'

# qualquer pessoa confere um PIX — sem chave nenhuma
curl https://api.luniumpay.com/v1/verificar/E12345678…

O final do amount dispara cada caminho de falha sob demanda: .01 retém e libera sozinho, .02 falha, .03 expira a cotação, .04 recusa por limite, .05 demora dois minutos. Integração que só viu o dia bom quebra no primeiro dia ruim.

Limites e prazos

Os números, sem letra miúda.

O quêQuantoPrazo
Cash-in (PIX → cripto)R$ 5,00 a R$ 6.000,00 por cobrançaQR vale 15 min · cripto sai após o pagamento
Cash-out (cripto → PIX)R$ 6,00 a R$ 250.000,00 por transação~10 s após a confirmação na Polygon
Payout (PIX em reais)R$ 1,00 a R$ 6.000,00 por enviosegundos, 24/7
Por pagador (CPF/CNPJ)R$ 100 no primeiro PIX · R$ 200 nas 24h · R$ 6.000/diaacima disso, retido 24 h antes de liberar
Teto diário da chaveR$ 5 mil → R$ 25 mil → R$ 100 milsobe com volume liquidado, sem pedir

Os limites atuais da sua chave vêm sempre em GET /keys/me — leia de lá, não fixe no código.

Comece agora

Receba a sandbox e fale com integração.

A chave de teste aparece aqui na tela, na hora. O resto vai para quem integra — respondemos no mesmo dia. Ainda comparando fornecedores? Use o checklist técnico de avaliação e migração.

Sua chave de teste — copie agora, ela não é mostrada de novo

Use no header X-API-Key, só no seu servidor. Nada liquida com ela. Quando quiser produção, é POST /keys — outra chamada só, sem aprovação humana.