Saltar al contenido principal
Logo de Landa Pay
Descargar la skill para IA

Instalación

Instala la librería landapay desde npm, configura tu API key en las variables de entorno LANDAPAY_ y verifica que tu proyecto Node.js o TypeScript esté listo.

Requisitos

  • Node.js 22.23.4 o superior. La librería usa el fetch nativo.
  • Un proyecto de Landa Pay con acceso a Desarrolladores para crear tu API key.
  • TypeScript es opcional: los tipos vienen incluidos en el paquete.

Instalar la librería

Terminal
npm install landapay

También funciona con otros gestores de paquetes:

Terminal
pnpm add landapayyarn add landapay

Configurar tu API key

La librería lee su configuración de variables de entorno que empiezan por LANDAPAY_. Crea la llave en el panel, en Desarrolladores, y guárdala en el .env de tu servidor.

.env.env
# Llave secretaLANDAPAY_API_KEY=lp_sk_test_... # Secreto de firma de tu endpoint de webhooks (obligatorio para recibir webhooks)LANDAPAY_WEBHOOK_SECRET=whsec_...
VariablePara qué sirve
LANDAPAY_API_KEYAPI key secreta (lp_sk_test_... o lp_sk_live_...). Obligatoria
LANDAPAY_WEBHOOK_SECRETSecreto de firma de tus webhooks (whsec_...). Obligatorio para recibir webhooks
LANDAPAY_TIMEOUTTiempo máximo por petición en milisegundos. Por defecto 30000
LANDAPAY_MAX_RETRIESReintentos automáticos ante errores de red, 429 y 5xx. Por defecto 2

La llave es secreta

Úsala solo en tu servidor. Nunca la incluyas en el código del navegador, en una app móvil ni en tu repositorio.

El resto de opciones está en Configuración.

Importar el cliente

landapay es una instancia lista para usar. Lee las variables de entorno la primera vez que haces una llamada, así que puedes cargar el .env con dotenv o con node --env-file=.env.

ESM o TypeScriptTypeScript
import "dotenv/config";import { landapay } from "landapay";
CommonJSJavaScript
require("dotenv/config");const { landapay } = require("landapay");

Si necesitas varias llaves o no quieres usar variables de entorno, crea tu propio cliente con new Landapay().

Verificar la instalación

Crea un link de pago de prueba. Si la llave es correcta verás su URL; si no, la librería lanza un AuthenticationError.

verificar.tsTypeScript
import "dotenv/config";import { landapay } from "landapay"; const link = await landapay.paymentLinks.create({  title: "Prueba de instalación",  amount: 1_000_000,}); console.log(landapay.livemode ? "Modo live" : "Modo de prueba", link.url);

Sigue con el Inicio rápido para cobrar tu primer pago de prueba.