Autenticación y modos
Autentica la librería landapay con tu API key secreta y separa el modo de prueba del modo live para integrar y probar cobros en Colombia sin mover dinero real.
API keys
La librería se autentica con tu API key secreta, que lee de LANDAPAY_API_KEY o de la opción apiKey. Crea las llaves en el panel, en Desarrolladores.
Usa la llave solo desde tu servidor
Si falta la llave, no tiene el formato correcto o está revocada, la llamada lanza un AuthenticationError. Las dos primeras se detectan sin hacer la petición.
import { AuthenticationError, landapay } from "landapay"; try { await landapay.payments.retrieve("pay_9ZXCVB2345NMLKJH");} catch (error) { if (error instanceof AuthenticationError) { // missing_api_key, invalid_api_key_format o invalid_api_key console.error(error.code, error.message); }}Modo de prueba y modo live
El prefijo de la llave define con qué datos trabaja:
| Prefijo | Qué hace |
|---|---|
lp_sk_test_ | Datos de prueba. Los cobros pasan por el entorno de pruebas y no mueven dinero real |
lp_sk_live_ | Datos reales. Los cobros mueven dinero |
Cada objeto trae livemode para saber en qué modo se creó, y una llave nunca ve los objetos del otro modo. En el cliente, landapay.livemode te dice si la llave configurada es live.
Un link de pago o una suscripción creados con una llave de prueba cobran en el entorno de pruebas: el checkout muestra el aviso de modo de prueba y solo acepta tarjetas y números de prueba, sin mover dinero real.
Usar varias llaves
Si necesitas trabajar con las dos llaves a la vez, crea un cliente por llave:
import Landapay from "landapay"; const test = new Landapay({ apiKey: process.env.LANDAPAY_TEST_KEY });const live = new Landapay({ apiKey: process.env.LANDAPAY_LIVE_KEY }); const client = process.env.NODE_ENV === "production" ? live : test;console.log(client.livemode);Revisa todos los errores posibles en Errores.