LunaPayLunaPay
LunaPay para desarrolladores y comercios

Cada estado, claro.

Una guía para cobrar, emitir y liquidar sin confundir operaciones distintas.

OpenAPI 3.1

Tres planes, sin abono mensual fijo

PlanCargo comercialDía mensualEmisión / salida
Básico Local8% + IVA aplicable a la comisión15CUIT propio · CBU/CVU local
Intermedio Global8% final, IVA incluido7CUIT propio · canales habilitados
Premium Compliance29% final · participación inicial 71%7Paradise como vendedor aprobado · API pública

El 29% no es una alícuota de IVA. Los canales internacionales requieren entidad, moneda, beneficiario y circuito de salida compatibles.

Primero, un checkout

Creá cliente, producto y precio en el panel. Emití una clave Premium con MFA y los scopes mínimos. El tenant y sandbox/live se derivan de esa clave. No envíes secretos al navegador.

curl "$LUNAPAY_ORIGIN/v1/checkout-sessions" \
  -H "Authorization: Bearer $LUNAPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-2026-00001" \
  -d '{"reference":"pedido-00001","contractId":"CONTRATO_UUID",
       "customerId":"CLIENTE_UUID","currency":"ARS",
       "items":[{"priceId":"PRECIO_UUID","quantity":1}]}'

La respuesta contiene data.url. Compartila con el comprador. Consultá GET /v1/payments/UUID para el estado confirmado. Un redirect exitoso no acredita dinero.

Todos los POST exigen Idempotency-Key. Reutilizarla con un payload distinto en una creación financiera da conflicto. En resultados inciertos, consultá; no cambies de proveedor para intentar cobrar otra vez.

Listas: ?limit=50&before=ULTIMO_UUID, orden descendente por fecha e ID. Los importes son strings de unidades menores: ARS/USD/EUR 2 decimales, USDT/USDC 6, BTC 8. No se suman monedas distintas.

Errores: {error:{code,message,requestId}}. 400 validación, 401 autenticación, 403 permiso/plan, 409 conflicto, 429 límite. Conservá requestId, nunca claves o datos completos de pago.

Suscripciones y prueba de un mes

Un precio recurrente puede incluir un mes calendario gratis. El fin de mes se ajusta al último día válido; los instantes se guardan UTC con política America/Argentina/Buenos_Aires. Crear una suscripción no prueba que exista un mandato ni que un ciclo esté pagado.

await fetch(origin + '/v1/subscriptions', {
  method: 'POST', headers: {Authorization: 'Bearer ' + key,
  'Content-Type':'application/json','Idempotency-Key':crypto.randomUUID()},
  body: JSON.stringify({customerId, priceId, contractId, accountId,
    mode:'automatic_recurring', termsVersion:'version-aceptada', consent:true})
});
// Renovación por enlace, sin débito: mode:'manual_renewal', sin accountId.
// Cancelar: POST /v1/subscriptions/UUID/cancel, body:{}.
// Renovar acceso al portal: POST /v1/subscriptions/UUID/portal, body:{}.

El portal privado permite consultar, cancelar y descargar los comprobantes propios aunque el comercio cambie de plan. Stripe admite actualización del medio con un portal de proveedor. Otros mandatos se gestionan desde la cuenta del proveedor; si no admite cambio, se cancela y se autoriza uno nuevo.

Payway: compra única en tres cuotas

Se envía el importe total una sola vez, con installments=3. Sólo ARS, tarjetas de crédito argentinas, marca/rango/fechas/canal de campaña y habilitación de la cuenta verificados. El total de las tres cuotas coincide con la compra; no hay interés para el comprador. La financiación y el margen se revisan por separado.

Facturación LunaPay

Básico e Intermedio conectan su propio CUIT desde Facturación. Nunca se solicita la clave fiscal. El asistente registra identidad y punto de venta, explica delegación o certificados y permite consultar permisos sin emitir. La inscripción, autorización y aceptación requieren evidencia; sandbox no habilita live.

Premium opera sólo con contrato, catálogo y entidad Paradise realmente aprobados. El vendedor define el emisor, no la moneda. Una venta local argentina usa el servicio fiscal aplicable; una exportación de la S.A. puede requerir WSFEX/Factura E. Una invoice extranjera de Stripe no reemplaza esa autorización.

La cola emite al hecho fiscal aprobado, sin esperar el retiro. Un timeout obliga a consultar el número reservado; no se reasigna ni se vuelve a cobrar. Un rechazo admite reparación auditada; un documento autorizado sólo se corrige con notas vinculadas.

Los PDFs identifican emisor/receptor, total, estado y autorización real. Sandbox y pendientes se marcan sin validez fiscal. La liquidación es otro documento. La disponibilidad de un PDF no demuestra presentación de impuestos.

Aceptar delegación en ARCA · Autorizar servicio de producción

Del pago al retiro

  1. Confirmar y conciliar la venta con el proveedor.
  2. Registrar la liberación efectiva de fondos, costos y retenciones.
  3. Cerrar el mes calendario anterior y aplicar día 7 o 15 y calendario aceptado.
  4. Solicitar retiro a un destino verificado; reservar saldo de forma atómica.
  5. Obtener doble aprobación, exportar instrucciones, presentar y conciliar la acreditación.

Exportar instrucciones no marca un retiro como pagado. USD no se convierte en ARS/USDT cambiando una etiqueta: cada conversión exige cotización, consentimiento y ejecución conciliada, con asientos separados por moneda. No existe recarga libre, inversión ni cash-out sin venta.

Reembolsos

POST /v1/refunds
{"orderId":"UUID","amountMinor":"10000","reason":"Solicitud del comprador",
 "feePolicy":"proportional","policyEvidence":"VERSION_CONTRACTUAL"}

Requiere scope financiero delegado por owner/admin con MFA. El éxito HTTP al solicitar no confirma el reembolso. Una devolución posterior al retiro puede generar deuda; no modifica la venta ni borra asientos históricos.

Notificaciones firmadas

Registrá tu endpoint HTTPS público en Desarrolladores. Los eventos llevan ID estable, ambiente y referencia mínima. La firma siempre es obligatoria; la entrega puede repetirse. Guardá el ID procesado en tu propia transacción.

import {createHmac,timingSafeEqual} from 'node:crypto';
const id = headers.get('lunapay-event-id');
const signature = Object.fromEntries(headers.get('lunapay-signature')
  .split(',').map(part => part.split('=')));
if (Math.abs(Date.now()/1000 - Number(signature.t)) > 300) throw Error('expired');
const expected = createHmac('sha256', secret)
  .update(id + '.' + signature.t + '.' + rawBody).digest('hex');
if (!/^[a-f0-9]{64}$/.test(signature.v1) ||
    !timingSafeEqual(Buffer.from(expected,'hex'),Buffer.from(signature.v1,'hex')))
  throw Error('invalid signature');
// Aplicar sólo si el event ID no se procesó, dentro de una transacción.

Eventos: payment.paid, invoice.authorized/rejected, settlement.available, payout.paid/returned, subscription.renewed. Los reintentos son durables con backoff; fallos agotados aparecen para revisión interna. No hay entrega «exactamente una vez».

Qué falta para operar en live

Credenciales y cuentas contratadas por proveedor/entidad; permisos de recurring/refunds cuando correspondan; convenios Payway y certificación de restricciones; identidades, contratos y reglas fiscales aprobados; CUIT, delegación/certificados, punto de venta y servicio ARCA; banco/proveedor de salida y beneficiarios verificados; calendario operativo aceptado; dominio HTTPS, base PostgreSQL con RLS, Supabase y correo con dominio verificado.

No se activa live con un flag ni con un ejemplo de prueba. Ningún pago, retiro o autorización fiscal real fue ejecutado para construir este entorno local.