LUNIUMFrequently asked questions
Timing, limits, fees, refunds and receipts — what people ask before integrating.
What is Lunium?
Settlement infrastructure between crypto assets and PIX. A company integrates the API and can then offer crypto sales paid out to any PIX key (cash-out), crypto purchases paid by PIX (cash-in) and open payment verification. Venda Cripto is the consumer-facing version, operated by the same company.
Do I need to sign up to test?
No sign-up or approval needed: POST /keys/sandbox with your email returns a test key in one call, and it runs the entire flow without moving money. The email is required because that is where we send the manual, the flowchart and the integration steps. A production key is also created with a single call (POST /keys).
How long does a sale (cash-out) take?
The quote is valid for 15 minutes; on Polygon the deposit is detected in seconds and the PIX is paid in about 1–2 minutes (measured median: 83 s over the last 90 days). On other networks the time depends on that blockchain's confirmations and is stated up front.
Which PIX keys can I pay out to?
You can provide a CPF, CNPJ, phone, email or random Pix key, subject to the operation's validations and limits. Recipient lookup is optional and depends on availability. Check available and verified; HTTP 200 alone does not establish that the recipient was verified. An unavailable lookup does not mean payments are unavailable.
What about paying a QR code (copy-and-paste)?
QR copy-and-paste payments use br_code when that mode is enabled for the operation. Confirm the asset, network and availability before offering the flow to your customer. Production may return 503 br_code_indisponivel even if the preview or sandbox accepts the QR. If a payment is rejected or refunded, follow the status and instructions for that same order.
What are the fees?
The sale quote is already net: the amount in reais you see is what the key receives. There is no additional fee. For cash-in (PIX to crypto), 2% + R$ 2.00 per charge on new keys (read GET /keys/me). A Pix payout debits the amount sent plus the fees applicable to your key. The total may include a Lunium service fee and a provider fee, which can be fixed or percentage based. Check your conditions through GET /saldo and reconcile the operation's fee_cents. Crypto conversions and withdrawals also depend on the chosen route's costs and minimums. There is no monthly fee.
What are the limits?
Cash-out: from R$ 6.00 to R$ 250,000.00 per transaction, with no daily ceiling per API key. What closes the day is the recipient: R$ 100,000.00 per CPF/CNPJ of whoever receives the PIX, resetting at midnight (Brasília time) — when the PIX key is not a tax number (email, phone, random), that ceiling applies per key, and we never ask for the seller's CPF. The effective maximum of one operation is the lower of the two: for a recipient who has received nothing yet today, R$ 100,000.00. Cash-in: from R$ 1.00 to R$ 6,000.00 per charge; per payer's CPF/CNPJ, the ladder is R$ 100.00 on the first operation → R$ 200.00 in the first 24 h → R$ 6,000.00/day; above the range, the QR is accepted with a 24 h hold at the provider, up to R$ 6,000.00/day — already on the first operation, with no history required. There is no daily ceiling per key: what bounds you is the per-operation range, the per-payer ladder on cash-in and the per-recipient ceiling on sales. Your key's current numbers are always at GET /keys/me.
What happens when something goes wrong?
Rejected key, reversed PIX, or a failure before sending: the crypto goes back to the refund_address given in the operation (or to the deposit's origin). When the funds were already with the settlement provider, the refund to the customer happens once that provider returns them to our custody, for the amount actually returned. The order ends in REFUNDED with the refund transaction hash.
Do I get a receipt?
Yes, in three forms: the official PIX identifier (E2E), a receipt page and a PDF — all of them in the API response and in the webhook. Anyone can check a payment at GET /v1/verificar/{e2e}, with no key.
I used the wrong network or address. Can it be recovered?
No. Blockchain transfers are irreversible, and a deposit on a network or asset different from the one quoted is held for manual handling. Always check the network before sending.
How do I track operations?
Through the API (GET /cash-outs/{id}), through a signed webhook, or through the Telegram agent, which reports every state change in your company's group and answers queries.
Who is the company behind Lunium?
ZANQUETA INTERMED LTDA, Brazilian company registry (CNPJ) 68.538.127/0001-00, headquartered in Americana, São Paulo. The same company operates Venda Cripto. Contact: contato@luniumpay.com.
Didn't find what you needed? Talk to us: contato@luniumpay.com · full documentation.