Infraestructura para tu próximo producto

Pix en tu producto.
Libertad en el
siguiente paso.

Recibe Pix y entrega USDT en la billetera elegida. O envía criptomonedas para pagar un Pix, con seguimiento y comprobante. También puedes mantener saldo en reales brasileños e integrar estos flujos en tu software.

Prueba sin dinero real Sin billetera fija para recibir fondos en custodia

¿Prefieres hablar? Atención humana por WhatsApp ↗

LUNIUMVISTA ILUSTRATIVA DEL PRODUCTO
Del pago al siguiente destinoConecta las posibilidades.
PixSaldo BRLUSDTUSDC+ catálogo
cash-in · ci_9f2e…
◎
PIX recibido
evento: cashin.paid
R$ 5.000,00
⇄
Convirtiendo
BRL → USDT
5,1047
Liquidación
USDT → Polygon
0x8ef1…
✓
Completado
evento: cashin.settled · tx confirmada on-chain
979,49 USDT
Ejemplo ilustrativo · estados por API y webhook
Webhooks firmados. Seguimiento de cada etapa.
¿Qué necesitas ahora?

Tu próximo pago,
por dos vías.

Descubre cómo funciona, prepara el flujo con tu IA y empieza por la prueba. Para operar, conecta tu cuenta y comprueba las condiciones antes de confirmar.

Recibir

Recibe Pix en USDT

Indica el importe, los datos del pagador y la billetera de destino. Genera el QR y sigue el Pix y el envío de USDT por la red elegida.

Consulta la estimación neta, las tarifas y las posibles retenciones antes de crear la solicitud de cobro.

Pagar

Paga Pix con criptomonedas

Indica una clave y el importe, o el código para copiar y pegar. Revisa la cotización, envía las criptomonedas según las instrucciones y haz el seguimiento hasta que el comprobante esté disponible.

Las monedas y redes siguen el catálogo. El código para copiar y pegar admite USDT/USDC en rutas compatibles.

Usa Gemini, ChatGPT o tu IA para entender y preparar la integración. Ejecutar pagos desde el chat requiere herramientas conectadas a tu cuenta. Ver formas de conexión.

Producto

Un punto de partida.
Todos tus flujos.

Cobros, saldos y salidas conectados por la misma API. Elige la vía que tenga sentido para tu producto.

Custodia BRL

Recibe Pix.
Elige la salida.

Recibe el importe neto en custodia en reales brasileños, organiza el saldo por cliente y elige después cuándo pagar o retirar.

Pixsaldo BRLPix o cripto

Sin billetera fija en la entrada. La red y la dirección se eligen al retirar criptomonedas.

Explorar la custodia →
Cash-in

PIX → USDT / USDC

Tu cliente paga un PIX normal. Lunium identifica el pago, realiza la conversión y liquida las stablecoins directamente en la dirección configurada.

PIXpago detectadoconversiónliquidaciónUSDT / USDC

Activos, redes, mínimos y estimaciones disponibles en el catálogo de la API.

Explorar cash-in →
Cash-out

Stablecoins → PIX

Envía USDT o USDC. Recibe una cotización, confirma la operación, deposita las stablecoins y Lunium ejecuta la liquidación mediante PIX.

USDT / USDCcotizaciónaceptacióndepósitoconfirmaciónPIX

Disponible en varias redes, según el catálogo de la API.

Explorar cash-out →
Payouts

Payouts en PIX, mediante la API

Envía PIX directamente desde tu sistema mediante la infraestructura de Lunium. Crea pagos, consulta el estado y concilia cada operación mediante la API.

POST /payoutsprocessingsent

Sin pasar por criptomonedas: reales brasileños directamente a la clave PIX.

Explorar payouts →
Recibe ahora. Decide después.

El Pix llega.
El siguiente paso
es tuyo.

El cobro puede permanecer en custodia en reales brasileños. Organiza los saldos por cliente y elige cómo mover el saldo disponible, sin definir una billetera de criptomonedas al recibir los fondos.

Conocer la custodia BRL

Las monedas, redes, tarifas y límites se consultan en la API antes de la operación.

ENTRADATu cliente paga con Pix
Custodia en reales brasileñosUn saldo.
Más posibilidades.
PixPagos y retiros
CriptoElige el activo y la red

Flujo ilustrativo · movimientos del saldo disponible

Lunium Partners

Tu cuenta. Del sandbox a producción.

Crea tu cuenta, entra en el panel de socios y prueba tu integración. Cuando estés listo, genera la clave de producción en la misma cuenta.

1 · Sandbox

Empieza por el sandbox

Genera tu clave de prueba en el panel y valida Pix, saldos y webhooks con dinero ficticio.

Desarrolladores

Integra sin esperarnos.

La infraestructura está diseñada para que los desarrolladores empiecen por la API sin depender de una reunión comercial.

01

Crea tu clave de prueba.

POST /keys/sandbox
02

Solicita una cotización.

POST /cashin/preview
03

Crea una solicitud de cobro PIX.

POST /cashin/charge
04

Recibe la liquidación.

cashin.settled

Sin aprovisionamiento manual de credenciales. Sin esperar a que alguien cree tu primera clave.

Tarifas

Tarifa por socio, que baja con el volumen.

Integración estándar: 3,3% + R$ 1,00 por operación. Los socios con volumen negocian la tarifa, que puede llegar a 35 bps sobre la cotización de referencia de mercado de USDT para socios exclusivos. Sin cuota mensual: la tarifa vigente de tu clave aparece en GET /keys/me y todas las cotizaciones ya son netas.

Código

Del PIX a las stablecoins en una integración.

solicitudnode
const response = await fetch(
  "https://api.luniumpay.com/cashin/charge",
  {
    method: "POST",
    headers: {
      "X-API-Key": process.env.LUNIUM_API_KEY,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      amount_cents: 25000,
      payer_tax_number: "12345678901",
      payout_address: "0x…",
      asset: "usdt",
      external_id: "order_8812"
    })
  }
);

const charge = await response.json();
respuesta200
{
  "cashin_id": "ci_b3f9d2a41c6e…",
  "status": "pending",
  "amount_cents": 25000,
  "chain": "polygon",
  "asset": "usdt",
  "qr_copypaste": "00020126…",
  "qr_image_url": "https://…",
  "external_id": "order_8812",
  "expires_at": "2026-…"
}

Tu aplicación recibe el PIX. Lunium se encarga del resto del recorrido.

Integración mediante software

Construye con tu equipo.
O con la IA que usas.

De ChatGPT a Fable, proporciona a tu IA el contexto de la API y una vía de integración. Tu equipo también puede empezar directamente por el código.

01

Integración por desarrollador

API REST directa, OpenAPI 3.1, sandbox determinista y producción. Nada ha cambiado: si ya tienes una integración, sigue funcionando igual.

Empezar a construir
02

Integración por agente

Descubrimiento mediante un estándar abierto, catálogo de funciones legible por máquina, política de gastos definida por el propio integrador y entrada en producción según reglas.

Lunium para agentes

Sandbox, OpenAPI y MCP. Descubrimiento, implementación, pruebas y paso a producción, según las autorizaciones y los requisitos de la API.

Operación

Cada evento.
Una visión de la operación.

Consulta la operación en el panel del socio y en el monitor restringido a tu cuenta. Integra el seguimiento en directo en tu producto mediante webhooks y consultas de estado.

  • Cash-in, cash-out y payouts
  • Estados y liquidaciones
  • Eventos operativos en tiempo real
  • Sin exponer tu secreto de API — el monitor tiene un token propio, de solo lectura y que se puede rotar
  • Confirma en tu backend la recepción y el procesamiento de los webhooks
monitor · ámbito: tu clave · solo lectura
cashin.paidR$ ••••,00procesando
cashin.settled•• USDT · polygonliquidado ✓
cashout.completedR$ ••••,00 · PIXpagado ✓
payout.sentR$ •••,00enviado ✓
webhookentrega firmada2xx ✓
Lunium Partners

Tú construyes.
Nosotros estamos cerca.

Únete a la comunidad oficial para seguir las novedades y los avisos operativos, e intercambiar experiencias con otros integradores.

Unirse a Lunium Partners
Personas reales junto a tu proyecto

Tu grupo de integración.

Recomendamos un grupo dedicado, creado por Lunium o por tu equipo, con los agentes humanos @luniumb2b y @luniumb2c. El bot y el monitor complementan este acompañamiento.

Hablar con una persona por WhatsAppIntegración · operación · consultas comerciales
Soluciones para tu negocio

Pix y stablecoins,
en el flujo de tu negocio.

Desde la venta en línea hasta el pago a proveedores, encuentra la aplicación de Lunium para tu operación.

Los detalles también importan

Una API que
puedes conocer por completo.

Explora los detalles de la operación. Catálogos, tarifas, estados, pruebas y recuperación de fallos, organizados para ti y tu equipo.

01Diseñada para producción
Producción

Hecha para desarrolladores.
Diseñada para producción.

OpenAPI 3.1

Especificación legible por máquina

Sincronizada con la API de producción y auditada contra ella.

Postman e Insomnia

Importa y prueba en minutos

Importa la especificación de la API y empieza a probar de inmediato.

Webhooks

Webhooks firmados

Verifica la autenticidad de cada evento mediante una firma criptográfica.

Idempotencia

Idempotencia nativa

Repite operaciones con seguridad, sin crear transacciones financieras duplicadas.

Errores

Errores estructurados

Implementa un tratamiento de errores previsible en lugar de interpretar mensajes de texto.

Catálogo

Catálogo dinámico

Descubre mediante código los activos y redes disponibles, sin fijar nada en el código.

Conciliación

Conciliación

Usa las respuestas de la API y los identificadores de liquidación como fuente de verdad financiera.

02Monedas, redes y catálogo
Redes

Cash-out en las redes que tus clientes ya usan.

El catálogo de Lunium publica los activos y las redes disponibles para cash-out en directo, en lugar de una tabla desactualizada.

USDT USDC
Polygon Ethereum BNB Chain Arbitrum Optimism Base Avalanche Aptos NEAR + las demás redes del catálogo — disponibilidad por activo en GET /catalog
GET /catalog

La disponibilidad cambia. Tu integración no tiene que adivinar — si aparece en el catálogo, está disponible.

03Cotizaciones y tarifas antes de operar
Cotización

Primero la cotización.
Después el dinero.

La infraestructura financiera nunca debería exigir que tu aplicación adivine el importe final.

Antes de crear un cash-in
POST /cashin/preview

Cotización sin crear nada, con la tarifa de tu clave ya aplicada.

Para cash-out
POST /cash-outs

Cotización con validez explícita. No ocurre nada hasta que aceptas.

La API devuelve los importes utilizados por la transacción.
Tu sistema muestra la cotización. Lunium sigue siendo la fuente de verdad.

04Estados de cada transacción
Ciclo de vida

Cada transacción tiene un ciclo de vida.

Cash-in
pendingpaidsettled ✓oexpired

Estados reales del contrato: el PIX pasa a paid; la entrega on-chain es el settlement_status (pending → sending → sent) y el evento cashin.settled avisa del momento de acreditar.

Cash-out
QUOTE_CREATEDAWAITING_DEPOSITDEPOSIT_DETECTEDcashout.processingCOMPLETED ✓

Los estados internos de conversión se agrupan en un único evento cashout.processing — no tienes que tratar cada uno.

Tu aplicación sigue el estado mediante la API y recibe cada transición por webhook.

05Idempotencia y recuperación de fallos
Idempotencia

Diseñada para que un reintento no se convierta en un pago duplicado.

Las APIs financieras fallan de forma distinta a las APIs comunes.

Las conexiones se cortan. Los servidores se reinician. Las respuestas agotan el tiempo de espera.
Y tu aplicación repite la llamada.

El modelo de idempotencia de Lunium permite que el mismo external_id haga referencia de forma segura a la misma operación financiera, incluso para recuperarla después de un error ambiguo.

Misma operación Mismo identificador Ninguna transacción duplicada
06Bot y operación por Telegram
Operación humana

API para tu software.
Agente para tu equipo.

Tu aplicación
api.luniumpay.com

Opera mediante la API de Lunium: crea, sigue y concilia mediante código.

Tu equipo
  • Pregunta sobre tu integración
  • Recibe alertas de transacciones en tiempo real
  • Abre el monitor en directo
  • Consulta la actividad operativa

API para máquinas. Agente para personas.

07Sandbox: escenarios de éxito y fallo
Sandbox

Pon a prueba los fallos antes de que ellos te pongan a prueba.

Prueba cobros Pix, custodia en reales brasileños, retiros en criptomonedas, payout Pix y transferencias internas con saldo ficticio. El sandbox reproduce los estados de la integración sin pagar Pix ni mover criptomonedas reales. En cash-out, los escenarios siguientes ayudan a probar los casos de éxito, retraso y fallo.

Transacción exitosael caso de éxito, con ejecución simulada
Transacción retrasadadesencadenante .01 — delayed que pasa automáticamente a pagada
Transacción fallidadesencadenante .02 — prueba tu tratamiento de errores
Cotización caducadadesencadenante .03 — demuestra que vuelves a cotizar
Error de límitedesencadenante .04 — con el objeto limits rellenado
Conflicto de idempotenciareutiliza un external_id y recibe el 409 real
Firma de webhookPOST /webhooks/test valida tu manejador
POST /keys/sandbox

Crea una credencial de prueba sin mover fondos reales — con una llamada.

08Configuración e historial mediante la API
Fuente de verdad

La propia API indica lo que hace.

No es una presentación de ventas. No es un PDF. Es la API.

GET /keys/meConfiguración de la cuenta, límites vigentes y elegibilidad, legibles por máquina.
GET /catalogActivos y redes disponibles ahora.
GET /cashin/chargesHistorial de cash-in.
GET /cash-outsHistorial de cash-out.
GET /payoutsHistorial de payouts.

Tu integración consulta la configuración vigente en lugar de depender de suposiciones.

09Qué comprobar antes de integrar
Antes de contratar

Infraestructura que puedes examinar antes de contratar.

La mayoría de las empresas de pagos te pide hablar con ventas antes de entender el producto. Lunium hace el recorrido inverso.

  • 01Lee la documentación.
  • 02Examina los endpoints.
  • 03Crea una clave de sandbox.
  • 04Entiende el ciclo de vida.
  • 05Prueba tu integración.

Después, habla con nosotros — cuando necesites límites de producción, condiciones comerciales o soporte empresarial.

Documentación

No te quedes con nuestra palabra.
Lee la API.

Operaciones documentadas en OpenAPI
OpenAPI 3.1
Esquemas de solicitud y respuesta
Ejemplos en cURL
Ejemplos en Node.js
Ejemplos en Python
Webhooks firmados documentados
Contratos de error
Escenarios de entorno de pruebas
Historial de cambios
Estado de producción

Tu próximo producto
empieza con una clave.

Empieza en el sandbox. Prueba el flujo. Lleva tu integración a producción.

Pix · Custodia BRL · Criptomonedas · Payouts

Soluciones y guías para integrar Pix

Elige el flujo de tu producto o consulta la central de integración.

API Pix para empresasSolicitudes de cobro, códigos QR, confirmación y pagos en tu sistema.Cómo elegir una API PixCompara proveedores, costes, pruebas y seguimiento operativo.API Pix con custodiaRecibe reales brasileños sin billetera fija. Separa el saldo por cliente y retira por Pix o en criptomonedas.Sandbox de pagosPrueba flujos completos, fallos y webhooks con saldo ficticio.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.
Preguntas directas

Las consultas que llegan antes de la primera llamada.

Respuestas cortas y verificables. El detalle completo está en Preguntas frecuentes y en documentación.

¿Cómo recibir PIX y liquidar en USDT?

Tu aplicación llama a POST /cashin/charge y recibe un código QR PIX (para copiar y pegar) que muestra al pagador. Cuando se liquida el PIX, el importe se acredita en USDT o USDC. El estado se consulta mediante GET /cashin/{id}/status y un webhook firmado.

¿Cómo aceptar stablecoins y pagar por PIX?

Es el recorrido inverso (cash-out): POST /cash-outs/preview cotiza; POST /cash-outs crea la orden; POST /cash-outs/{id}/accept devuelve la dirección de depósito. Una vez confirmado el depósito en USDT o USDC, el PIX se envía a la clave indicada.

¿Necesito registrarme para probar la API?

En el panel, crea una cuenta para organizar tus claves de sandbox y producción. El acceso directo por API sigue disponible: POST /keys/sandbox con tu correo crea una clave de prueba con una llamada, sin una cuenta en el panel. Los agentes de IA siguen usando Mesh o MCP. El sandbox simula Pix a custodia o criptomonedas, retiros por Pix y en criptomonedas, transferencias internas y criptomonedas a Pix. Incluye estados, fallos y webhooks. El saldo es ficticio y el QR no se puede pagar; los pagos reales requieren producción. El correo es obligatorio porque allí enviamos el manual, el diagrama de flujo y la guía de integración paso a paso.

¿Qué monedas y redes se admiten?

Consulta GET /cashin/catalog para recibir cripto tras un Pix y GET /catalog para depositar cripto y recibir Pix. USDT, USDC y otros activos dependen del flujo, de la red y de la disponibilidad vigente. Los catálogos de ambos sentidos son diferentes; confirma la ruta antes de ofrecer el pago.

¿A qué claves PIX puede pagar la API?

Cualquier clave: CPF, CNPJ, teléfono, correo o clave aleatoria. La API valida el formato. La consulta auxiliar del titular puede no estar disponible; comprueba el resultado devuelto y los datos del destinatario.

¿Es posible verificar un pago sin tener una cuenta?

Sí. GET /v1/verificar/{e2e} es una ruta abierta: con el identificador de extremo a extremo del PIX, cualquiera puede comprobar si ese pago se ha liquidado, sin clave de acceso.

¿Cuánto cuesta?

No hay cuota mensual: se cobra por operación. La tarifa vigente de tu clave figura en GET /keys/me y la cotización ya muestra el importe neto. Los detalles están en luniumpay.com/faq.

¿Quién opera Lunium?

ZANQUETA INTERMED LTDA, CNPJ 68.538.127/0001-00, con sede en Americana/SP. Contacto: contato@luniumpay.com.

Habla con nuestro equipo

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