LunaPay® · Documentación

De tu primer cobro a una integración propia.

Descargar OpenAPI 3.1

Revisado el 19/09/2026

Integrar la API Pro

Autenticación de servidor, mínimo privilegio y separación de ambientes.

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.

Claves y scopes

Las claves lp_sandbox_… y lp_live_… se envían como Authorization: Bearer. El tenant y ambiente se derivan de la clave, no de un ID enviado por el cliente. Owner/admin/developer pueden emitir claves con MFA; los scopes financieros solo los delega owner/admin. El contrato Pro debe estar vigente.

Idempotencia y errores

Todos los POST requieren Idempotency-Key de 8 a 200 caracteres. En creaciones financieras, reutilizar una clave con otro payload produce conflicto. Conservá requestId al diagnosticar. Respuesta de error: {error:{code,message,requestId}}. HTTP 400 valida datos, 401 autenticación, 403 permisos/plan, 404 recurso, 409 conflicto, 429 límite y 500 error interno.

Paginación y límites

Listas: limit de 1 a 100, por defecto 50, y before con el último UUID recibido. Orden descendente por creación e ID. El límite actual es 300 solicitudes por minuto por comercio y ambiente. Aplicá backoff; no reintentes cargos a ciegas.

Ejemplo de servidor

Usá variables privadas y verificá HTTP antes de procesar data. La documentación no ofrece un botón para ejecutar solicitudes live.

Ejemplo de servidor
const key = process.env.LUNAPAY_API_KEY;
if (!key) throw new Error('Missing server API key');
const response = await fetch('https://payments.lunapay.ar/v1/payments?limit=50', {
  headers: { Authorization: 'Bearer ' + key },
});
const payload = await response.json();
if (!response.ok) throw new Error(payload.error?.code || 'API_ERROR');
const payments = payload.data;

Contrato de desarrollo · fuente: Payments · 9f82d06

Siguiente guíaWebhooks verificados