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 (PIX que vira cripto), 2% + R$ 2,00 por cobrança. No PIX → PIX e no saque, 1% mais R$ 2,00 por envio. 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$ 5,00 a R$ 6.000,00 por cobrança; por CPF/CNPJ do pagador, até R$ 100,00 na primeira operação e até R$ 200,00 nas primeiras 24h o dinheiro entra na hora e, de R$ 200,00 a R$ 6.000,00 por dia, o QR também é aceito, com o valor retido por 24h antes de liberar — já na primeira operação, sem precisar de histórico. A escada de tier por chave (R$ 5 mil → R$ 25 mil → R$ 100 mil por dia) vale para cash-in e payouts, nunca para a 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.