Introducción a la librería landapay

Documentación oficial de landapay, la librería de Node.js para cobrar con Landa Pay en Colombia: links de pago, suscripciones y webhooks tipados con TypeScript.

landapay es la librería oficial de Landa Pay para Node.js. Con ella creas links de pago y suscripciones, consultas los pagos que recibes y verificas los webhooks de tu servidor, todo con tipos de TypeScript y sin armar peticiones HTTP a mano.

Lee tu API key de la variable de entorno LANDAPAY_API_KEY.
Reintenta sola los errores de red y evita duplicados con llaves de idempotencia.
Devuelve objetos tipados y errores con clases propias para manejarlos con facilidad.
Funciona con ESM y CommonJS en Node.js 22.23.4 o superior.

Skill para tu IA

Descarga la skill de Landa Pay y úsala en Cursor, Claude, Codex u otro asistente que lea un SKILL.md. Con ella integra la librería con las reglas de cobro y, cuando haga falta el detalle vigente, lee estas páginas en docs.landapay.co.

Descargar skill

Descarga el archivo y descomprímelo.
Deja la carpeta landapay dentro de las skills de tu agente: .cursor/skills/ en Cursor, .claude/skills/ en Claude o .agents/skills/ en Codex y otros agentes con el mismo formato.
Tiene que quedar un SKILL.md dentro de esa carpeta. Reinicia el agente para que la tome.

Así se ve

Cobrar con landapayTypeScript

1import { landapay } from "landapay";2 3// Cobro único4const link = await landapay.paymentLinks.create({5  title: "Pedido A-1001",6  amount: 15_000_000, // $150.000 COP en centavos7});8 9// Suscripción con el plan definido aquí mismo10const { checkoutUrl } = await landapay.subscriptions.create({11  plan: { interval: "monthly", amount: 4_990_000, trialDays: 14 },12  customer: { name: "María Gómez", email: "[email protected]" },13});

Empieza aquí

InstalaciónInstala landapay desde npm y configura tu API key en las variables de entorno.Inicio rápidoCrea tu primer link de pago y tu primera suscripción de prueba en pocos minutos.ConfiguraciónVariables de entorno, opciones del cliente, reintentos, montos y fechas de la librería landapay.ErroresClases de error tipadas de la librería landapay y cómo manejarlas en tu integración.

Guías

Paso a paso para los casos de uso más comunes.

Cobrar con links de pagoCrea un link de pago, compártelo y confirma el cobro antes de entregar el pedido.Cobrar suscripcionesSuscribe a tus clientes con una sola llamada y activa su acceso con webhooks.Recibir webhooksVerifica la firma y procesa eventos tipados de pagos y suscripciones.

Módulos del SDK

Cada módulo tiene su página con sus métodos, parámetros y ejemplos listos para copiar.

ClienteCrea el cliente de Landa Pay o usa la instancia lista que lee tu configuración de las variables de entorno.landapayLinks de pagoCrea links de monto fijo para cobrar con tarjeta, Nequi, Bancolombia o PSE, consúltalos, edítalos y desactívalos.landapay.paymentLinksSuscripcionesSuscribe a tus clientes con un plan existente o definido en la misma llamada, y consulta, actualiza, cambia de plan, cancela, reanuda o abre la página para actualizar el método de pago.landapay.subscriptionsPlanesCrea planes reutilizables con precio, frecuencia, prueba gratis y precios introductorios. Para un plan de un solo uso, defínelo al crear la suscripción.landapay.plansClientesCrea, consulta y actualiza los clientes de tu proyecto. También puedes crearlos al vuelo al suscribir con subscriptions.create.landapay.customersPagosConsulta un pago recibido por un link o por el cobro de una suscripción y confirma si fue aprobado antes de entregar el pedido.landapay.paymentsWebhooksVerifica la firma de los webhooks que envía Landa Pay y obtén el evento tipado, listo para usar con un switch sobre event.type.landapay.webhooks