Versiones

Cambios que hacemos en v1 sin previo aviso: endpoints nuevos, campos opcionales nuevos en las peticiones, campos nuevos en las respuestas, tipos de evento nuevos, valores nuevos en campos documentados como listas abiertas (como mechanic o history_entry.type) y códigos de error nuevos. Escribe tu código de forma que ignore los campos y valores desconocidos en lugar de rechazarlos.

Todo lo que pueda romper una integración que funciona (eliminar o renombrar un campo, cambiar un tipo, hacer obligatorio un campo opcional) va a una versión nueva. Lo anunciamos con al menos seis meses de antelación, y v1 sigue funcionando durante ese tiempo.

Todos los cambios se publican en el Registro de cambios.

La API de POS anterior

Las integraciones creadas sobre https://loyaltyfy.io/api/pos/v1 siguen funcionando. Las integraciones nuevas deben usar /api/v1: acepta los mismos campos card_number y gross_amount, funciona con todos los tipos de programa (no solo cashback) y añade webhooks, claves de idempotencia y permisos.