LUNIUM
Lunium · API PIX ↔ stablecoins

Preguntas frecuentes

Actualizado el 21 de septiembre de 2026

Plazos, límites, tarifas, devolución y comprobante: lo que se pregunta antes de integrar.

¿Qué es Lunium?

Infraestructura de liquidación entre criptoactivos y PIX. Una empresa integra la API y puede ofrecer venta de criptomonedas con PIX a cualquier clave (cash-out), compra de criptomonedas pagando PIX (cash-in) y verificación abierta de pagos. Venda Cripto es la versión para particulares, operada por la misma empresa.

¿Necesito registrarme para probar?

No necesitas registro ni aprobación: POST /keys/sandbox con tu correo devuelve una clave de prueba en la propia respuesta, con la que puedes ejecutar todo el flujo sin mover dinero. El correo es obligatorio porque allí enviamos el manual, el diagrama de flujo y la guía de integración paso a paso. La clave de producción también se crea mediante una llamada (POST /keys).

¿Cuánto tarda una venta (cash-out)?

La cotización es válida durante 15 minutos; en Polygon, el depósito se detecta en segundos y el PIX se paga en aproximadamente 1–2 minutos (mediana histórica documentada el 21/09/2026: 83 s en una muestra de 90 días). En otras redes, el plazo depende de las confirmaciones de la blockchain y se informa de antemano.

¿A qué claves PIX puedo pagar?

Puedes indicar una clave CPF, CNPJ, de teléfono, correo o aleatoria, según las validaciones y los límites de la operación. La consulta del titular es auxiliar y depende de su disponibilidad. Comprueba available y verified; una respuesta HTTP 200 por sí sola no confirma al titular. La falta de disponibilidad de la consulta no significa que el pago no esté disponible.

¿Y pagar un código QR para copiar y pegar?

El pago de un QR para copiar y pegar usa el campo br_code cuando esta modalidad está habilitada para la operación. Confirma el activo, la red y la disponibilidad antes de ofrecer el flujo al cliente. Producción puede devolver 503 br_code_indisponivel, aunque la prueba o la vista previa acepten el QR. En caso de rechazo o devolución, sigue el estado y las instrucciones de la misma orden.

¿Cuáles son las tarifas?

La cotización de venta ya es neta: el importe en reales brasileños mostrado es el que recibe la clave. No hay una tarifa adicional. En cash-in (PIX que se convierte en criptomonedas), 3,3% + R$ 1,00 por solicitud de cobro. En payout Pix, el débito incluye el importe enviado y las tarifas aplicables a tu clave. La tarifa total puede reunir el servicio de Lunium y el coste del proveedor, que puede ser fijo o porcentual. Consulta las condiciones en GET /saldo y comprueba fee_cents en la operación. Para la conversión y el retiro en criptomonedas, consulta también los costes y mínimos de la ruta elegida. Las tarifas negociadas por volumen aparecen en GET /keys/me. No hay cuota mensual.

¿Cuáles son los límites?

Cash-out: de R$ 6,00 a R$ 250.000,00 por transacción, sin límite diario por clave de API. El límite diario se aplica al destinatario: R$ 100.000,00 por CPF/CNPJ de quien recibe el PIX, renovado a medianoche (hora de Brasilia). Cuando la clave PIX no es un documento (correo, teléfono o aleatoria), el límite se aplica por clave, y nunca pedimos el CPF del vendedor. El máximo efectivo de una operación es el menor de ambos: para un destinatario que aún no haya recibido nada ese día, R$ 100.000,00. Cash-in: de R$ 1,00 a R$ 6.000,00 por solicitud de cobro; por CPF/CNPJ del pagador, los tramos son R$ 100,00 en la primera operación → R$ 200,00 durante las primeras 24 h → R$ 6.000,00/día; por encima del tramo, el QR se acepta con una retención de 24 h en el proveedor, hasta R$ 6.000,00/día, ya desde la primera operación y sin necesidad de historial. No hay un límite diario por clave: lo que limita es el tramo por operación, los límites del pagador en cash-in y el límite del destinatario en la venta. Los valores vigentes de tu clave están siempre en GET /keys/me.

¿Qué ocurre cuando algo falla?

Clave rechazada, PIX revertido o fallo antes del envío: las criptomonedas se devuelven a la refund_address confirmada por el cliente, en la red de devolución. Nunca al origen del depósito. Si aún no se ha indicado la billetera, sigue AWAITING_REFUND_ADDRESS e indícala en la misma orden. Si el importe ya estaba con el liquidador, la devolución al cliente se realiza en cuanto este lo devuelve a nuestra custodia, por el importe devuelto. La orden termina en REFUNDED con el hash de la devolución.

¿Recibo un comprobante?

Sí, en tres formas: el identificador oficial del PIX (E2E), una página del comprobante y el PDF, todos en la respuesta de la API y en el webhook. Cualquiera puede comprobar un pago en GET /v1/verificar/{e2e}, sin clave.

Me equivoqué de red o dirección. ¿Se puede recuperar?

No. Las transferencias en blockchain son irreversibles, y un depósito en una red o activo distintos de los cotizados queda retenido para su tratamiento manual. Comprueba siempre la red antes de enviar.

¿Cómo sigo las operaciones?

Mediante la API (GET /cash-outs/{id}), un webhook firmado o el agente de Telegram, que avisa de cada cambio de estado en el grupo de tu empresa y responde a las consultas.

¿Qué empresa está detrás de Lunium?

ZANQUETA INTERMED LTDA, CNPJ 68.538.127/0001-00, con sede en Americana/SP, la misma que opera Venda Cripto. Contacto: contato@luniumpay.com.

¿No has encontrado lo que necesitabas? Habla con nosotros: contato@luniumpay.com · documentación completa.

Por caso de uso

API de PIX a USDTRecibe reales brasileños y entrega USDT en la billetera del cliente.API de USDT a PIXVende stablecoins y paga a cualquier clave PIX.API de payout PIXPaga a proveedores y usuarios en reales brasileños mediante la API.BRL ↔ USDT por APIConversión en ambos sentidos, con cotización y comprobante.On-ramp y off-ramp en BrasilEntrada y salida de criptomonedas en el país, con una sola integración.PIX en el checkout, stablecoins en la tesoreríaRecibe PIX de tus clientes y conserva los fondos en dólares digitales.PIX y stablecoins para billeterasOfrece a tus usuarios una vía de entrada y salida.Infraestructura con tu marcaToda la vía de procesamiento detrás de tu producto.

Habla con quienes lo construyeron

La clave de prueba se obtiene con una llamada, sin aprobación previa. Si es lo que buscas, empieza por la documentación. Este formulario es para las demás consultas: tarifas por volumen, un caso que la documentación no cubre o una duda antes de integrar.

¿Prefieres escribir directamente por correo? contato@luniumpay.com