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.
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