SDK JavaScript / Node
Biblioteca oficial de iPagos para Node.js (servidor) y navegadores modernos (tokenización en cliente). Distribuida vía npm.
Instalación
npm install @ipagos/node
# o
pnpm add @ipagos/node
# o
yarn add @ipagos/nodeRequiere Node 18 o superior.
Inicialización
import { IPagos } from '@ipagos/node';
const ipagos = new IPagos(process.env.IPAGOS_SECRET_KEY, {
apiVersion: '2026-01-15',
maxRetries: 3,
});Crear un pago
const payment = await ipagos.payments.create({
amount: 25000,
currency: 'MXN',
source: 'tok_visa_4242',
description: 'Pedido #1042',
metadata: { order_id: '1042' },
}, {
idempotencyKey: crypto.randomUUID(),
});
console.log(payment.id, payment.status);Iterar resultados
for await (const payment of ipagos.payments.list({ limit: 100 })) {
await handle(payment);
}Tokenización en navegador
<script src="https://js.ipagos.lat/v1"></script>
<script>
const ipagos = IPagos('pk_sandbox_xxxxxxxxxxxxxxxxxxxxx');
const elements = ipagos.elements();
const card = elements.create('card');
card.mount('#card-element');
document.getElementById('pay').onclick = async () => {
const { token, error } = await ipagos.createToken(card);
if (error) return alert(error.message);
await fetch('/api/charge', {
method: 'POST',
body: JSON.stringify({ token: token.id }),
});
};
</script>