Inicio rápido
Inicio rápido de la librería landapay: crea tu primer link de pago y tu primera suscripción con datos de prueba en pocos minutos, sin mover dinero real.
Crear una API key
En el panel de Landa Pay entra a Desarrolladores y crea una API key en modo Test. Con ella trabajas con datos de prueba, sin mover dinero real.
El secreto solo se muestra una vez
Instalar y configurar
npm install landapay dotenvLANDAPAY_API_KEY=lp_sk_test_...Crear tu primer link de pago
Los montos van en centavos: 15_000_000 son $150.000 COP. Si no envías currency, el link cobra en pesos colombianos.
import "dotenv/config";import { landapay } from "landapay"; const link = await landapay.paymentLinks.create({ title: "Pedido A-1001", amount: 15_000_000, // $150.000 COP redirectUrl: "https://tutienda.com/pago", metadata: { orderId: "A-1001" },}); console.log(link.id, link.url);Abre la url para ver el checkout. Como usaste una llave de prueba, muestra el aviso de modo de prueba y solo acepta tarjetas y números de prueba.
Crear tu primera suscripción
No necesitas crear el plan antes: defínelo en la misma llamada. La librería crea el plan y el cliente, y te devuelve el checkout donde el cliente registra su método de pago.
const { checkoutUrl, plan } = await landapay.subscriptions.create({ plan: { name: "Plan Pro", interval: "monthly", amount: 4_990_000, // $49.900 COP al mes trialDays: 7, }, customer: { name: "María Gómez", email: "[email protected]" }, externalId: "user_42",}); console.log(plan?.id, checkoutUrl);La suscripción se crea cuando el cliente completa el checkout. Te enteras con el webhook subscription.created, como explica Cobrar suscripciones.
Revisar las peticiones
En la pestaña Logs de Desarrolladores ves cada petición que hizo la librería con su respuesta. Se guardan los últimos 30 días.
Siguientes pasos
- Confirma el cobro antes de entregar el pedido con Cobrar con links de pago.
- Recibe los eventos en tu servidor con Recibir webhooks.
- Maneja los fallos con las clases de Errores.
- Consulta todos los métodos en la referencia del SDK.