LunaPay® · Documentación

De tu primer cobro a una integración propia.

Descargar OpenAPI 3.1

Revisado el 19/09/2026

MVP · Inicio, historial y Mercado

Recorrido de la demo de LunaPay®: movimientos primero, activos en Mercado y precios cripto informativos en tiempo real.

Ejemplos para ejecutar en tu servidor con datos propios de sandbox. Las claves nunca se incluyen en el frontend. Esta documentación no habilita operaciones live.

Inicio y movimientos

Cuenta muestra los saldos de ejemplo en ARS y USD con sus banderas circulares, Agregar / Enviar / Cambiar / Pagar y las últimas tres transacciones antes de Novedades. Novedades conserva la tira horizontal de Paradise Store y LunaCard: promociones de la tienda y acceso a la solicitud de tarjeta. Crypto se encuentra en Mercado.

Historial completo

Ver más abre el historial con 12 operaciones ilustrativas, búsqueda por nombre, tipo, moneda o referencia y filtros Todos / Ingresos / Egresos. Cada fila abre un detalle con importe, fecha, contraparte, estado y referencia. Los comprobantes son de ejemplo; no acreditan operaciones reales.

USD como activo del portfolio

Tocar el saldo USD de Inicio abre Mercado → Portfolio. Mercado reúne Portfolio, Explorar, Acciones y Crypto. Portfolio ofrece Comprar, Vender, Enviar y Solicitar. Vender abre la conversión con selectores de moneda de origen y destino, incluido USDT → USD o USD → ARS, para revisar el importe antes de confirmar el ejemplo. Los USD figuran separados de BTC, ETH y USDT y pueden tener distintos orígenes: depósito ACH o Wire, cambio ARS → USD o conversión Crypto → USD. Un origen no implica otro y USD no es USDT ni USDC. Las cantidades y los saldos de la demo son ilustrativos.

Precios reales y disponibilidad

La demo consulta GET /api/demo-market, con datos validados de CoinGecko (Coinbase como respaldo) y actualización cada 60 segundos mientras la vista está activa. Muestra fuente y hora de recepción. Si falla, informa precios no disponibles o desactualizados; no reemplaza el precio por una cifra ficticia. El total del portfolio estima cantidades ilustrativas con precios informativos. Conversión a otras divisas, acciones y dólar digital permanecen simulados.

Operatoria de ejemplo

El historial incluye depósitos internacionales ACH / Wire, transferencias recibidas y enviadas, cambios ARS → USD, compra y venta de cripto, cobros con QR o link y pagos de servicios y consumos con LunaCard Prepaga. No recibe depósitos, ejecuta cambios, emite tarjetas ni mueve fondos.

Préstamos: simulación y seguimiento

Desde Perfil → Préstamos, ingresá un ingreso mensual de ejemplo y simulá entre ARS 25.000 y 800.000 en 3, 6, 9 o 12 cuotas. El monto y el plazo recalculan la cuota y el total. El calendario desglosa capital, intereses e IVA, con TNA, TEA, CFT TEA con IVA y vencimientos. TNA 76% e IVA 21% sobre intereses son parámetros ilustrativos, no una oferta vigente. La referencia del 35% de ingresos permite ajustar monto y plazo; no consulta una central de crédito. La revisión exige confirmar las condiciones. El préstamo de ejemplo permite pagar cuotas, consultar comprobantes y seguir el total pendiente hasta cancelarlo. Los ingresos y pagos permanecen en memoria durante la sesión, sin otorgar crédito ni modificar saldos reales.

Cuentas por región y LunaPayTag

Más → Datos de tu cuenta permite elegir Argentina en ARS, Argentina en USD, Estados Unidos en USD o Europa en EUR. Cada selección muestra únicamente sus datos: alias y CVU para ARS; alias y CBU para USD Argentina; routing ACH o Wire y número de cuenta para Estados Unidos; IBAN y BIC / SWIFT para Europa, con vías SEPA y SWIFT. El botón de copia toma el dato seleccionado o los datos de esa cuenta. LunaPayTag es único para el perfil: comienza con $, usa $indigo en el ejemplo y se puede editar con 3 a 20 letras, números o guiones bajos. El mismo tag aparece debajo del avatar y encima del nombre en Más, y en la pantalla para recibir transferencias. Selección y edición se conservan en memoria durante la sesión. No se verifica disponibilidad del tag en un servidor ni se emiten cuentas reales; los datos bancarios son ejemplos no operativos.

Negocio y notificaciones

Negocio permite editar nombre, rubro, dirección y otros datos del perfil durante la sesión y generar QR o links de cobro de demostración. Para su imagen se elige un avatar predeterminado de tienda, café, tecnología, moda, restaurante o luna; no se cargan fotos locales. El avatar elegido aparece en el perfil y checkout de ejemplo. La campana muestra avisos de cobros, seguridad, tarjeta y negocio con acciones relacionadas y preferencias de notificación. Los enlaces abren un checkout simulado; no efectúan cargos.

Neil · Asistente IA de la billetera

Neil reemplaza a LunaBot con el astronauta original de Figma. Desde Centro de ayuda o Contactanos podés iniciar un chat con IA, seguir preguntando y abrir Tarjetas, cuentas por región, Portfolio, Negocio, Préstamos y otras funciones relacionadas. Las respuestas usan la documentación del MVP y, al consultar precios, la fuente de cotizaciones disponible. No ejecuta operaciones ni contacta a un asesor por vos; el formulario de soporte se abre por separado. La conversación permanece en memoria durante la sesión y se puede borrar. Los mensajes y un contexto limitado de la demo (cuenta seleccionada, plan, tipo de tarjeta, etapa del préstamo y cantidad de avisos sin leer) se envían al proveedor de IA mediante Vercel AI Gateway. No se adjuntan automáticamente tu foto, email, teléfono, ingresos ni datos bancarios. No ingreses información sensible. Un filtro protege patrones evidentes de PIN, CVV, códigos y números largos, pero no garantiza detectar todos los datos privados. Si la IA falla, permite reintentar o elegir Ayuda guiada, identificada como tal. Neil puede equivocarse: verificá información relevante en las pantallas y documentación. ES / EN / PT y claro / oscuro usan la misma funcionalidad.

Contrato de desarrollo · fuente: Payments · 9f82d06

Siguiente guíaAlta y habilitación