Novedades de la API

Los cambios de la Integration API que ves como integrador: nuevo, cambios, correcciones y qué tenés que hacer.

Lo que cambia en la Integration API y en el Portal, con la fecha en que llegó a Producción. Los cambios del SDK y del checkout están en Novedades del widget.

Cada entrada tiene un tipo (Nuevo, Cambio, Corrección o Deprecación) y cierra con lo que tenés que hacer. Requiere acción marca lo que puede romper tu integración si no lo mirás.

3 de noviembre de 2026

Cambio · Portal · El Portal tiene menú nuevo: Inicio, Cobros, Comercios, Credenciales, Webhooks, Simulador y Configuración. La URL del webhook y el secreto de firma pasaron a Webhooks, y las direcciones de retorno a Credenciales. Los links viejos siguen funcionando. ¿Tenés que hacer algo? No.

Nuevo · Portal · En Configuración elegís la apariencia del widget, las devoluciones automáticas y los avisos por WhatsApp. Las devoluciones y la apariencia las habilita Chytapay a pedido; los avisos por WhatsApp ya vienen habilitados. Ver Funciones por integración. ¿Tenés que hacer algo? Solo si querés usarlas.

Cambio · Avisos por WhatsApp · sendWhatsappNotification ya no es obligatorio cuando el cobro tiene amount. Si lo omitís, rige lo que elegiste para tu integración en el Portal, y el aviso arranca apagado. sendEmailNotification sigue siendo obligatorio con monto. En un lote, si un ítem manda true, todos los ítems con monto tienen que mandar el campo. ¿Tenés que hacer algo? Si creás cobros sin el campo y esperás el aviso, mandá sendWhatsappNotification: true o prendé el aviso en el Portal.

31 de octubre de 2026

Nuevo · Portal · Elegís en el Portal qué devoluciones automáticas corren y qué mensajes de WhatsApp salen por defecto, dentro de lo que Chytapay habilitó para tu integración (los avisos por WhatsApp vienen habilitados). ¿Tenés que hacer algo? No.

30 de octubre de 2026

Cambio · Avisos por WhatsApp · El aviso del cobro y la confirmación de pago se habilitan por integración. Si un cobro pide un mensaje que Chytapay no habilitó, la API responde 403 (WhatsappNotEnabledError, WhatsappNotificationNotAllowedError o WhatsappPaymentConfirmationNotAllowedError). Ver WhatsApp. ¿Tenés que hacer algo? No, salvo que recibas esos 403: escribinos para habilitarlos.

29 de octubre de 2026

Nuevo · Documento precargado en el checkout · POST /payment-request con type: "checkout" acepta customer.taxDocument (DNI, CUIL o CUIT). El widget arranca con ese documento en lugar de pedirlo, y el pagador puede cambiarlo. Cualquier otro campo de customer da 400. Ver Widget. ¿Tenés que hacer algo? No. Es opcional.

26 de octubre de 2026

Nuevo · Devoluciones por API · Podés devolver un cobro total o en varias parciales con POST /payment-request/{referenceId}/refunds y consultar cada devolución con GET /refunds/{refundId}. El resultado llega por los webhooks refund.succeeded y refund.failed, que vienen apagados. El header Idempotency-Key es obligatorio: reintentar con la misma clave no genera una segunda devolución, y la misma clave con otro cuerpo da 422. Responde 403 hasta que Chytapay habilita las devoluciones para tu integración y, además, cada comercio las autoriza por API: se pide a Chytapay con la autorización escrita del comercio (RefundsNotConsentedError). Ver Devoluciones. ¿Tenés que hacer algo? Solo si querés usarlas: pedí la habilitación.

Nuevo · Devoluciones automáticas · Chytapay puede devolver solo el excedente de un pago, los pagos de menos y las transferencias que no corresponden a ningún cobro. Cada modo lo habilita Chytapay y lo elegís vos. Ver Devoluciones automáticas. ¿Tenés que hacer algo? No, salvo que quieras usarlas.

Cambio · Estados refunded y partially_refunded · Un cobro puede pasar a refunded o partially_refunded, también cuando la devolución la hace el comercio o soporte, aunque no uses la API de devoluciones. Aparecen en GET /payment-request, en el detalle del cobro y en los webhooks. Requiere acción si tu código rechaza estados que no conoce: sumá los dos valores.

Cambio · Motivos de payment.unmatched · Hay dos motivos nuevos, refunded (el cobro ya estaba devuelto) y partial_not_accepted (el pago era menor al total y se devolvió entero). Los dos traen paymentRequest. Ver Pagos sin imputar. Requiere acción si tu código descarta los motivos que no conoce.

Cambio · Entrega de webhooks · Las entregas mandan Accept-Encoding: identity. Si tu servidor responde una redirección, seguimos hasta 3 (307 y 308 reenvían el POST con su firma; 301, 302 y 303 pasan a GET sin cuerpo). La prueba de URL del Portal ya no sigue redirecciones: un 3xx se informa como respuesta que no es 2xx. ¿Tenés que hacer algo? Si tu URL de webhook redirige, configurá la URL final.

Cambio · Alcance del idToken del OAuth · El idToken que recibís al conectar un comercio sirve para la Integration API. Las otras APIs de Chytapay ya no lo aceptan. ¿Tenés que hacer algo? No, si solo usás la Integration API.

22 de octubre de 2026

Corrección · status del listado de cobros · GET /payment-request devolvía status con valores internos (pago_total, pendiente). Ahora devuelve los del contrato (total_payment, pending), igual que el resto de la API. Requiere acción si te adaptaste a los valores viejos.

Nuevo · Webhook al imputar un pago a mano · Cuando el comercio imputa a mano una transferencia a un cobro, te llega payment_request.payment_received con el estado resultante. Antes no llegaba nada. ¿Tenés que hacer algo? No. Si deduplicás por X-Chytapay-Webhook-Id, ya está cubierto.

21 de octubre de 2026

Nuevo · Más datos en payment.unmatched · El evento suma merchantUserId, merchantTaxId, merchantName y tenantKey. tenantKey viaja solo si el comercio está en una sede. No se sacó ningún campo. ¿Tenés que hacer algo? No.

15 de octubre de 2026

Nuevo · Asistente de documentación (MCP) · Podés conectar tu asistente de código al servidor MCP de Chytapay para consultar esta documentación. Ver Conectar tu asistente. ¿Tenés que hacer algo? No.

Cambio · User-Agent de los webhooks · Las entregas salen con User-Agent: Chytapay-Webhooks/1.0 y la prueba del Portal con Chytapay-Webhooks/1.0 (test). Antes salían con node, y algunos firewalls las bloqueaban. ¿Tenés que hacer algo? Si filtrás bots, permití Chytapay-Webhooks.

Nuevo · GET /me · Devuelve la identidad del comercio dueño del token y su vínculo con tu integración, sin abrir el idToken ni crear un cobro. Ver Confirmar el comercio. ¿Tenés que hacer algo? No.

10 de octubre de 2026

Corrección · Errores de validación por largo · Un texto más largo que lo permitido en los datos de tu integración daba 500. Ahora da 400 con el campo y el máximo. ¿Tenés que hacer algo? No.

8 de octubre de 2026

Nuevo · Historial de entregas de webhook · En el Portal ves cada evento con su estado (delivered, retrying o failed) y sus intentos. Se guarda 60 días. ¿Tenés que hacer algo? No.