quicklink-sdk

SDK oficial de la QuickLink Pay API — una sola integración para cobrar y pagar sobre los rieles bancarios de Venezuela (Pago Móvil, Crédito Inmediato, Débito Inmediato/C2P). Sin dependencias (usa fetch nativo, Node ≥ 18). Montos en VES.

Instalación

npm i quicklink-sdk

Uso

import { QuickLink } from 'quicklink-sdk';

const ql = new QuickLink({
  baseUrl: 'https://pay.quickoffer.io',
  apiKey: 'mi_comercio:sk_test_…', // <comercio>:<api_key>; el modo (test/live) lo fija la llave
});

// Cobro C2P (token → OTP → cobro)
const token = await ql.cobrarToken({ /* … */ });
const res = await ql.cobrar({ /* …, otp */ });

// Pago (Crédito Inmediato por defecto)
await ql.pagar({ /* … */ });

// Consultar estado
await ql.consultar({ id: res.id });

La autenticación es la cabecera x-switch-key: <comercio>:<api_key>. El modo (test/live) lo fija la API key, no el cliente — no envíes mode ni tenant_id.

• Docs: https://docs.quickoffer.io
• OpenAPI: https://docs.quickoffer.io/openapi.json

Publicar

npm run build
npm publish            # requiere `npm login` (cuenta de QuickOffer)

MIT.