Novedades

​

Cambios que pueden afectar tu integración

• Booleanos estrictos en POST /v2/debts y POST/PATCH /subscriptions: allowOverduePayment, allowPartialPayments, autopay y enforcePaymentOrder aceptan solo true/false. "true", 1, etc. devuelven 400 con details[]. description debe ser string (400). Ver Convenciones de la API.
• additionalData en POST /v2/debts, POST /payment-links y POST/PATCH /subscriptions: debe ser un objeto plano y no puede usar claves reservadas (description, paymentMethods, productName, etc.). Si no, 400. Ver Convenciones de la API.
• POST /payment-links: un externalClientId que no corresponde a un contacto devuelve 422 BUSINESS_RULE_VIOLATION (antes se creaba la liga igual). Ver Ligas de pago.
• POST/PATCH /payment-links: expiresAt debe ser un date-time RFC 3339 (2026-12-31 23:59 o solo fecha devuelven 400). En el PATCH, expiresAt: null devuelve 400 (antes 500; las ligas siempre vencen), metadata null o que no sea objeto devuelve 400 y description vacía devuelve 400. Ver Ligas de pago.
• PATCH /subscriptions/{id}: valida tipos, el enum de paymentMethods y la exclusión entre autopay: true y paymentMethods (400). Una suscripción CANCELLED o ENDED devuelve 422 (antes 200). Ver Suscripciones.
• POST /subscriptions: intervalUnit distingue mayúsculas (MONTH devuelve 400) y, si la programación es inválida, no se crea el producto ni el contacto en línea. Ver Suscripciones.
• PATCH /contacts/{id}: phones: [] devuelve 400 (antes 200 sin efecto). Ver Contactos.
• GET /contacts: identifier y externalClientId con valores distintos devuelven 400. Ver Contactos.
• GET /products: active distinto de true/false devuelve 400 (antes se leía como false). Ver Productos.
• GET /payment-links: createdAtFrom/createdAtTo con formato inválido devuelven 400 (antes se comparaban como texto). Ver Ligas de pago.
• GET /subscriptions: externalClientId ahora filtra (antes se ignoraba y devolvía suscripciones de otros contactos). Vacío o en blanco devuelve 400. Ver Suscripciones.
• GET /debts/{id}, PATCH /debts/{id}, POST /debts/{id}/cancel: una deuda cancelada se puede leer (200, status: CANCELLED); cancelarla otra vez o hacerle PATCH devuelve 422 (antes 404). Ver Deudas.
• POST /v2/debts: nuevo valor autopayReason: "NO_PRODUCT". Si validas autopayReason contra una lista cerrada, agrégalo. Ver Débito automático.
• Fechas en contactos, deudas y pagos de ligas: los date-time se devuelven en UTC con milisegundos y Z (2026-09-24T21:09:41.835Z). Antes podían venir sin zona, con +00:00 o con microsegundos. Ver Convenciones de la API.
• PATCH /debts/{id}: dueDate en la respuesta pasa a YYYY-MM-DD (antes date-time). Ver Deudas.
• POST /payment-links sin deudor: paymentUrl pasa a ser la URL corta (ya no contiene el identifierValue) y puede ser null si falla su generación. Trátala como una URL opaca. Ver Ligas de pago.
• Ligas de pago, todas las respuestas: expiresAt se devuelve siempre en UTC con milisegundos y Z (2026-12-31T23:59:59.000Z), aunque se haya enviado con offset (-06:00). Las ligas antiguas guardadas con fecha sola (2026-12-01) salen como el inicio de ese día UTC (2026-12-01T00:00:00.000Z). Ver Ligas de pago.
• Ligas de pago sin llave externa, todas las respuestas: externalPaymentLinkId es null cuando la liga se creó sin externalPaymentLinkId ni header Idempotency-Key (antes devolvía un valor plk_<uuid> igual al paymentLinkId). Ver Ligas de pago.
• GET /debts y GET /payment-links/{id}/payments: createdAtTo como fecha sola ahora incluye ese día (antes filtraba hasta su inicio). Si enviabas el día siguiente para compensar, ahora recibes un día de más. createdAtFrom posterior a createdAtTo devuelve 400 con el mensaje createdAtFrom must be earlier than or equal to createdAtTo. Ver Deudas.

​

Correcciones

• PATCH /debts/{id} y PATCH /subscriptions/{id}: el PATCH ya no reinicia allowPartialPayments a false, y amountPaid sale correcto (no null). Ver Deudas.
• GET /debts/{id} y GET /debts: description aparece en las lecturas. Ver Deudas.
• POST /v2/debts y POST /subscriptions: contact.contactId viene con el prefijo con_ también cuando el contacto se crea en línea. Ver Débito automático.
• GET /contacts: identifier filtra, y contactCode acepta el prefijo con_. Ver Contactos.
• Contactos: los contactos sin email creados en línea devuelven email: null (antes el texto "null"), también al leer los ya existentes. Ver Contactos.
• GET /payment-links?externalPaymentLinkId=: deja de devolver 500. Ver Ligas de pago.
• POST /payment-links: un externalPaymentLinkId repetido devuelve 409 sin crear la deuda. Una liga con deudor ya no falla con 500 si la configuración del portal no responde. Ver Ligas de pago.
• PATCH /payment-links/{id}: expiresAt actualiza también el vencimiento de la deuda de la liga. Si esa deuda ya fue cancelada, se actualiza solo la liga (antes el PATCH fallaba). Ver Ligas de pago.
• Respuesta de ligas de pago: siempre trae externalPaymentLinkId, expiresAt, successUrl, metadata, identifierValue, contact y product, con null cuando no hay valor. Ver Ligas de pago.
• POST /products: devuelve lo que se guardó (timestamps, externalProductId, active) en lugar de repetir el request. Ver Productos.
• PATCH /products/{id}: active: false desactiva el producto; renombrar a un nombre ya usado, también por un producto inactivo, devuelve 409 (antes 500); tipos inválidos devuelven 400 (antes 500). Ver Productos.
• POST /subscriptions: paymentUrl ya no es null, y scheduling.billingDay se infiere de startDate (para month y year). Ver Suscripciones.
• GET /debts y GET /payment-links/{id}/payments: createdAtFrom/createdAtTo aceptan date-time RFC 3339 además de fecha. Con la misma fecha en los dos devuelven las deudas de ese día (antes 400), y un createdAtFrom futuro sin createdAtTo devuelve una página vacía (antes 400). Ver Deudas.
• PATCH de contactos, productos, ligas de pago, suscripciones y deudas: companyCode en el cuerpo se toma como contexto y ya no se rechaza como campo no editable. Ver Convenciones de la API.
• POST /v2/debts (lote): cada error de details[] trae field. Ver Débito automático.
• PATCH /debts/{id}: las fechas imposibles (2026-02-30) devuelven 400. Ver Deudas.
• POST /v2/debts, POST /payment-links y suscripciones: additionalData enviado como objeto se guarda en la deuda (antes se perdía en deudas y ligas). Ver Convenciones de la API.
• PATCH /subscriptions/{id}: si falla la actualización de alguna deuda de la suscripción, la respuesta es 207 con error.code: PARTIAL_UPDATE (antes 500 INTERNAL_ERROR). La suscripción queda actualizada. Ver Suscripciones.
• paymentUrl en deudas, suscripciones y ligas de pago: si tu compañía no tiene configurados los links privados, paymentUrl ya no viene en null: se devuelve la URL del portal de tu compañía. Trátala igual como una URL opaca. Ver Deudas.