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 precisa de cadastro nem aprovação: POST /keys/sandbox com o seu e-mail devolve uma chave de teste na própria resposta, que roda o fluxo inteiro sem mover dinheiro. O e-mail é obrigatório porque é para ele que mandamos o manual, o fluxograma e o passo a passo da integração. 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; na Polygon o depósito é detectado em segundos e o PIX é pago em cerca de 1–2 minutos (mediana medida: 83 s nos últimos 90 dias). Em outras redes o prazo depende das confirmações da blockchain e é informado antes.
Para quais chaves PIX posso pagar?
Você pode informar chave CPF, CNPJ, telefone, e-mail ou aleatória, conforme as validações e os limites da operação. A consulta de titular é auxiliar e depende de disponibilidade. Confira available e verified; uma resposta HTTP 200, sozinha, não confirma o titular. A indisponibilidade da consulta não significa que o pagamento esteja indisponível.
E pagar um QR code (copia e cola)?
O pagamento de QR copia e cola usa o campo br_code quando essa modalidade está habilitada para a operação. Confirme ativo, rede e disponibilidade antes de oferecer o fluxo ao cliente. A produção pode retornar 503 br_code_indisponivel, mesmo se o teste ou a prévia aceitar o QR. Em caso de recusa ou devolução, acompanhe o estado e as instruções da mesma ordem.
Quais são as taxas?
A cotação da venda já é líquida: o valor em reais mostrado é o que a chave recebe. Não há taxa adicional. No cash-in (PIX que vira cripto), 2% + R$ 2,00 por cobrança. No payout Pix, o débito inclui o valor enviado e as tarifas aplicáveis à sua chave. A tarifa total pode reunir o serviço Lunium e o custo do provedor, que pode ser fixo ou percentual. Consulte as condições em GET /saldo e confira fee_cents na operação. Para conversão e saque em cripto, consulte também os custos e mínimos da rota escolhida. Taxas negociadas por volume aparecem em GET /keys/me. Não há mensalidade.
Quais são os limites?
Cash-out: de R$ 6,00 a R$ 250.000,00 por transação, sem teto diário por chave de API. O que fecha o dia é o recebedor: R$ 100.000,00 por CPF/CNPJ de quem recebe o PIX, renovando à meia-noite (horário de Brasília) — quando a chave PIX não é um documento (e-mail, telefone, aleatória), o teto vale por chave, e nunca pedimos o CPF de quem vende. O máximo efetivo de uma operação é o menor dos dois: para um recebedor que ainda não recebeu nada no dia, R$ 100.000,00. Cash-in: de R$ 1,00 a R$ 6.000,00 por cobrança; por CPF/CNPJ do pagador, a escada é R$ 100,00 na primeira operação → R$ 200,00 nas primeiras 24 h → R$ 6.000,00/dia; acima da faixa, o QR é aceito com retenção de 24 h no provedor, até R$ 6.000,00/dia — já na primeira operação, sem precisar de histórico. Não há teto diário por chave: o que limita é a faixa por operação, a régua por pagador no cash-in e o teto por recebedor na venda. Os números vigentes da sua chave estão sempre em GET /keys/me.
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.