mt2mx

Cliente oficial de Node.js para MT2MX — convierte mensajes SWIFT MT940/MT950 a ISO 20022 camt.053.

Requiere Node.js >= 18 (usa el fetch global, sin dependencias externas).

Instalación

npm install mt2mx

Uso

const { MT2MXClient } = require("mt2mx");

const client = new MT2MXClient("sk_live_TU_API_KEY");

const xml = await client.convert(mt940Message); // consume 1 crédito de tu paquete

const result = await client.validate(mt940Message); // gratis, no consume créditos
// { valid: true, format: "MT940", detail: null }

const info = await client.me();
// { client_id: "...", credits_remaining: 87, credits_expire_at: "..." }

const historial = await client.logs(10);

El cliente maneja automáticamente la obtención y renovación del token de acceso — solo necesitas tu API key.

Manejo de errores

const { MT2MXClient, MT2MXCreditsError, MT2MXAuthError, MT2MXAPIError } = require("mt2mx");

const client = new MT2MXClient("sk_live_TU_API_KEY");

try {
  const xml = await client.convert(mt940Message);
} catch (e) {
  if (e instanceof MT2MXCreditsError) {
    console.log("Paquete de conversiones agotado o vencido");
  } else if (e instanceof MT2MXAuthError) {
    console.log("API key inválida");
  } else if (e instanceof MT2MXAPIError) {
    console.log(`Error ${e.statusCode}: ${e.detail}`);
  }
}

Documentación completa

https://mt2mx.cl/ayuda

Licencia

MIT