Novedades

Changelog

Historial de cambios del API Gateway v1 y de los cinco SDK oficiales (Python, JavaScript/TypeScript, PHP, .NET y Go).

En esta página

El API sigue la versión mayor v1 y los SDK usan SemVer alineado (1.x ↔ v1). Los cambios compatibles (operaciones, campos y eventos nuevos) llegan sin cambiar de versión mayor; ver Versionado y deprecaciones.

API Gateway #

2026-10-27 — Seis módulos nuevos (contrato con 115 operaciones) #

El contrato publicado pasa de 17 a 115 operaciones (102 rutas):

  • Billetera operativa: saldo, movimientos, P2P, Bre-B, facturas y recargas, que se suman a cuentas y bolsillos, tarjetas y FX. Evento nuevo wallets.topup.completed.
  • Cartera (loans): créditos del afiliado, plan de cuotas, desglose, pagos, recaudos, abonos extraordinarios, pago total y certificado. Eventos payment.received, payment.applied, installment.overdue, loan.paid_off.
  • PQRS para el CRM o el call center. Eventos pqrs.created, pqrs.status_changed, pqrs.responded.
  • Servicios de salud para IPS: agenda y citas, facturación de salud (DIAN, RIPS, glosas, recaudo del pagador) y carné de vacunación. Eventos appointment.* y health_billing.payment.registered.
  • Administrativo / ERP: talento humano, nómina, contabilidad y tesorería. Eventos admin.*.
  • Webhooks autogestionados por API: catálogo de eventos, endpoints, rotación del secreto, eventos de prueba, historial de entregas y reentregas.
  • El catálogo de eventos suscribibles llega a 52.

2026-07 — Billetera (cuentas, tarjetas, FX) y sandbox #

  • Cuentas y bolsillos, emisión y estado de tarjetas, cotización y conversión de divisas.
  • Superficie de sandbox: relojes de prueba y simuladores de ciclo de vida.
  • Eventos wallets.* (recargas, transferencias, desembolsos a billetera, retiros, pagos, disputas, tarjetas).

2026-06 — Primera versión (v1) #

  • Afiliados (cruce, carga por archivo, consulta), créditos (radicar, bandeja, detalle, decisión, desembolso), subsidios y cuota monetaria, estado de transacciones y salud del gateway.
  • Autenticación por X-API-Key, idempotencia, límites de tasa, errores RFC 9457.
  • Eventos de créditos, subsidios, cuota monetaria y afiliados, más el ciclo de crédito clásico.

SDK #

1.1.0 — 2026-11-02 (los cinco SDK) #

  • Python (compense-sdk-python): de 17 a 115 operaciones; módulos wallet, loans, pqrs, health, admin y webhooks; entorno dev; OffsetPage, Resolution, WebhookEndpoint; verificación de webhooks con varios secretos, tolerance=None, is_test y catálogo EVENT_TYPES de 52 eventos; CLI ampliada. Corregido: el entorno sandbox apunta ahora a https://sandbox.dev.compense.co/gw; FX envía sell_currency/buy_currency; enumeraciones de billetera en minúsculas; los relojes envían delta_seconds. Deprecado: sandbox.trigger_webhook, simulate.wallet_transfer_advance/credit_disburse_advance, test_clocks.create(name=), advance(by_seconds=) y from_currency/to_currency.
  • JavaScript / TypeScript (@compense/sdk): primera versión, con la superficie completa sobre fetch nativo, sin dependencias, ESM + CommonJS, paginación asíncrona, verificación de webhooks con node:crypto y Web Crypto, y CLI.
  • PHP (compense/sdk): primera versión, sobre cualquier cliente PSR-18, PHP 8.1+, con ejemplos para Laravel.
  • .NET (Compense.Sdk): primera versión para net8.0 y netstandard2.0, AddCompense con IHttpClientFactory, auto-paginación con IAsyncEnumerable.
  • Go: primera versión, solo biblioteca estándar, opciones funcionales, iteradores y el subpaquete webhook con Handler.

Todos comparten el mismo contrato fijado (gateway develop 9cf78da) y pruebas de paridad en ambos sentidos. Los JS, PHP, .NET y Go empiezan en 1.1.0 para alinearse con el de Python.

1.0.0 — 2026-07 (Python) #

Primera versión del SDK de Python: afiliados, créditos, subsidios, cuota monetaria, transacciones, sistema, cuentas/tarjetas/FX, ayudas de sandbox y la CLI compense; errores tipados, idempotencia, reintentos, avisos de deprecación y verificación de webhooks.

Documentación #

2026-11 — Nuevo sitio para desarrolladores #

Sitio rehecho sin dependencias de temas: guías de implementación por módulo con pestañas de código en los cinco SDK y cURL, referencia del API generada desde el contrato, webhooks, sandbox, recetas, búsqueda en el navegador y modo claro/oscuro.