LUNIUMPerguntas frequentes
Prazos, limites, taxas, devolução e comprovante — o que perguntam antes de integrar.
O que é a Lunium?
Infraestrutura de liquidação entre criptoativos e PIX. Uma empresa integra a API e passa a oferecer venda de cripto com PIX para qualquer chave (cash-out), compra de cripto pagando PIX (cash-in) e verificação aberta de pagamentos. O Venda Cripto é a versão para pessoas, operada pela mesma empresa.
Preciso de cadastro para testar?
Não. POST /keys/sandbox devolve uma chave de teste na hora, sem nenhum dado, que roda o fluxo inteiro sem mover dinheiro. A chave de produção também é criada por uma chamada (POST /keys).
Quanto tempo leva uma venda (cash-out)?
Cotação válida por 15 minutos; depois que o depósito é confirmado na Polygon, o PIX sai em cerca de 10 segundos (medido em produção). Em outras redes o prazo depende das confirmações da blockchain e é informado antes.
Para quais chaves PIX posso pagar?
Qualquer chave: CPF, CNPJ, telefone, e-mail ou chave aleatória — de qualquer pessoa. A API normaliza o formato e confirma o titular no diretório do PIX antes de pagar.
E pagar um QR code (copia e cola)?
Somente com USDT ou USDC na Polygon, pelo campo br_code. O valor e o recebedor saem do próprio QR. Se o liquidante recusar a cobrança, a cripto volta para a carteira de retorno da operação.
Quais são as taxas?
No cash-out pela API, 0,20% da Lunium mais as taxas do liquidante (1% + R$ 0,17), já embutidas na cotação: o valor em reais mostrado é o que a chave recebe. No cash-in a taxa é acordada por chave. Não há mensalidade.
Quais são os limites?
Cash-out: de R$ 6,00 a R$ 250.000,00 por operação, com teto diário por chave que sobe com o volume liquidado (R$ 5 mil → R$ 25 mil → R$ 100 mil por dia) ou por acordo. Cash-in: limites por CPF/CNPJ do pagador, que evoluem com o histórico.
O que acontece quando algo dá errado?
Chave recusada, PIX revertido ou falha antes do envio: a cripto volta para a refund_address informada na operação (ou para a origem do depósito). Quando o valor já estava com o liquidante, a devolução ao cliente acontece assim que ele devolve à nossa custódia, no valor devolvido. A ordem termina em REFUNDED com o hash da devolução.
Recebo comprovante?
Sim, em três formas: o identificador oficial do PIX (E2E), uma página do comprovante e o PDF — todos na resposta da API e no webhook. Qualquer pessoa pode conferir um pagamento em GET /v1/verificar/{e2e}, sem chave.
Errei a rede ou o endereço. Dá para recuperar?
Não. Transferências em blockchain são irreversíveis, e um depósito em rede ou ativo diferente do cotado fica retido para tratamento manual. Confira sempre a rede antes de enviar.
Como acompanho as operações?
Pela API (GET /cash-outs/{id}), por webhook assinado ou pelo agente no Telegram, que avisa cada mudança de estado no grupo da sua empresa e responde consultas.
Quem é a empresa por trás da Lunium?
ZANQUETA INTERMED LTDA, CNPJ 68.538.127/0001-00, com sede em Americana/SP — a mesma que opera o Venda Cripto. Contato: contato@luniumpay.com.
Não achou o que precisava? Fale com a gente: contato@luniumpay.com · documentação completa.