# Novedades

> El registro de cambios de la API de Lane y de su documentación: rutas, campos, eventos y códigos de error nuevos, y lo que cambió de comportamiento, con la fecha en que salió.

Lo que cambió para quien integra, con la fecha en que salió a producción. Lo más nuevo, arriba.

Cada entrada dice de un vistazo si tienes que hacer algo: **Nuevo** no rompe nada de lo que ya tenías; **Cambio** altera algo que ya existía, así que conviene leerlo; **Corrección** arregla la documentación sin que la API haya cambiado.

## 25 de octubre de 2026

- **Nuevo · Cobros: Un cobro rechazado dice si conviene reintentar.** Un cobro `failed` trae `decline`: `status_detail` (el motivo, como `INSUFFICIENT_FUNDS`) y `advice_action`, el consejo de la red: `RETRY`, `UPDATE_AND_RETRY`, `AUTHENTICATE_AND_RETRY` o `DO_NOT_RETRY`. Viene en la respuesta del cobro, en `GET /v1/payments/{id}` y en el aviso `payment.failed`. Si el rechazo llega como error (`4xx`), el error trae `payment_id` y `decline`. [Ver más](https://lane.money/docs/api/cobros)
- **Cambio · Cobros: La respuesta de un cobro ya no repite la del procesador.** `POST /v1/payments` y las operaciones sobre un cobro ya no traen `provider.response` ni `provider.endpoint`: `provider` solo dice `name: "processor"` (y la operación, en un cobro). Lo útil de esa respuesta ya estaba en los campos del cobro: `installment`, `parent_transaction_data` y ahora `decline`. Un error del procesador trae `details` solo cuando su motivo es una frase corta; nunca su cuerpo. [Ver más](https://lane.money/docs/api/cobros)
- **Nuevo · Cobros: `cleared_at` también en el detalle de un cobro.** `GET /v1/payments/{id}` trae `cleared_at`, la fecha en que la red compensó el cobro, como ya lo hacía el listado. [Ver más](https://lane.money/docs/api/cobros)
- **Corrección · Referencia: La referencia dice lo que la API hace hoy.** Se corrigieron los ejemplos de respuesta de cobros y operaciones; un reembolso parcial deja el cobro en `succeeded` y suma `refunded_amount` (y admite `reason` y `comment`); la `metadata` no vuelve intacta; los avisos `dispute.created` y `dispute.updated` llegan también al comercio; clientes pagina con cursor; los estados de una disputa y los campos de una suscripción; los mensajes de validación, que ya llegan en español; y los códigos `502`, `operation_not_supported_for_method`, `extra_items_not_supported` y `contact_rejected`. [Ver más](https://lane.money/docs/errores)

## 20 de octubre de 2026

- **Cambio · Cobros: La metadata descarta las llaves `lane_` y `blink_`.** Al crear un cobro, una sesión o una suscripción, las llaves de `metadata` que empiezan por `lane_` o `blink_` se descartan: son nombres que usa Lane. La metadata de cobros y suscripciones tampoco las muestra. En algunos cobros por PSE, Nequi, Daviplata o Bre-B anteriores a esta fecha, `provider_payment_id` viene vacío. [Ver más](https://lane.money/docs/api/cobros)

## 18 de octubre de 2026

- **Cambio · Webhooks: Los reintentos de un webhook terminan a los 3 días.** Una entrega a la que tu endpoint responde con un código fuera de `2xx` ya no se reintenta sin fin: se deja de intentar 3 días después de creado el evento y queda como fallida, igual que una a la que no se pudo conectar (que antes se daba por fallida al quinto intento). Desde **Desarrolladores → Webhooks** puedes reenviarla cuando tu endpoint esté arreglado. [Ver más](https://lane.money/docs/webhooks)

## 12 de octubre de 2026

- **Corrección · Sandbox: Tarjetas de prueba para aprobar, rechazar, reembolsar y autenticar.** La página de Sandbox ahora trae todas las tarjetas de prueba: seis que aprueban (débito y crédito, Visa y Mastercard), cinco que fuerzan un rechazo con su motivo, la que aprueba el cobro y rechaza el reembolso, y las de 3-D Secure con y sin desafío. Antes decía que no había tarjetas de rechazo ni una de crédito confirmada. La fecha de vencimiento y el código pueden ser cualesquiera. [Ver más](https://lane.money/docs/sandbox)

## 11 de octubre de 2026

- **Nuevo · Plataformas: Crear la cuenta de tu plataforma, desde cualquier país.** Una empresa que viene a ser plataforma crea su cuenta en `https://lane.money/auth/signup?como=plataforma`. No necesita tener un comercio en Colombia: dice de qué país es y el equipo de Lane la habilita con sus condiciones. [Ver más](https://lane.money/docs/guias/plataformas)

## 10 de octubre de 2026

- **Cambio · Cobros con tarjeta: Con tarjeta, `payment.succeeded` llega cuando el banco aprueba.** Un cobro con tarjeta y captura automática, que es la de defecto, ahora se lee como `succeeded` desde la autorización: en la respuesta de la API, en las listas y en el aviso, que pasa a ser `payment.succeeded`. La captura la hace el procesador después y ya no genera un segundo aviso. El estado `authorized` y el evento `payment.authorized` quedan solo para una preautorización (`capture.mode: MANUAL`). Si tu integración esperaba `payment.authorized` y después `payment.succeeded`, ahora recibe solo el segundo: despacha con ese. [Ver más](https://lane.money/docs/estados)
- **Nuevo · MCP: Consultar tu cuenta de prueba desde un asistente.** Un segundo servidor MCP lee tu cuenta en modo de prueba: cobros, contracargos, clientes, suscripciones y, para plataformas, comercios conectados y enlaces de registro. Solo lee, solo acepta llaves `sk_test_` y entrega los datos del comprador enmascarados. Se conecta en `https://lane.money/mcp/cuenta` o se corre en tu máquina. [Ver más](https://lane.money/docs/mcp)
- **Nuevo · Documentación: Guías de plataformas, por partes.** La guía de plataformas pasó a ser un grupo propio con seis páginas: el mapa de caminos, traer comercios, crear cobros, avisos, lo que ganas y probar la integración. [Ver más](https://lane.money/docs/guias/plataformas)
- **Nuevo · MCP: El servidor MCP calcula y revisa.** Además de buscar y leer la documentación, ahora tiene `convertir_monto`, `medios_para_monto`, `validar_peticion`, `explicar_error`, `explicar_evento` y `novedades`, y el objetivo `plataforma` en `guia_de_integracion`. Ninguna toca la API ni pide llave. [Ver más](https://lane.money/docs/mcp)
- **Nuevo · Plataformas: Avisos `merchant.approved` y `merchant.rejected`.** Una plataforma se entera cuando termina la revisión para cobros reales de un comercio conectado: `merchant.approved` si ya puede cobrar de verdad, `merchant.rejected` si no pasó. Llegan a todos sus endpoints, de prueba y reales. [Ver más](https://lane.money/docs/plataformas/avisos)
- **Cambio · Activación: Un comercio adjunta sus documentos al activarse.** El formulario de activación pide los documentos del comercio: una empresa adjunta cámara de comercio, RUT, cédula del representante legal y certificación bancaria; una persona natural, su cédula y la certificación bancaria. Sin ellos el comercio no se activa. [Ver más](https://lane.money/docs/plataformas/comercios)
- **Cambio · Medios de pago: Un cobro solo ofrece los medios que el comercio tiene.** Cada medio se habilita por comercio y por modo. Pedir uno que el comercio no tiene responde `422` con `code: payment_method_unavailable`, y `details` dice cuáles sí tiene. Antes el cobro se creaba y el comprador encontraba el error al pagar. [Ver más](https://lane.money/docs/guias/medios-instantaneos)
- **Nuevo · API: `Idempotency-Key` en todo lo que mueve plata.** La cabecera se acepta también en `POST /v1/payments`, en las operaciones sobre un cobro (devolver, capturar, anular) y en `POST /v1/enrollment/sessions`. Un `504` con `charge_unconfirmed` no se reintenta: se consulta el cobro. [Ver más](https://lane.money/docs/errores)
- **Corrección · Documentación: El cuerpo de un aviso y la forma de un error.** La documentación decía dos cosas que no eran ciertas. El cobro de un aviso va en `data.payment` y no trae tu `metadata` (vuelve al consultar el cobro). Y un error trae `error`, `code`, a veces `details`, y `request_id`. La API no cambió. [Ver más](https://lane.money/docs/webhooks)

## 9 de octubre de 2026

- **Nuevo · Plataformas: Cobrar a nombre de tus comercios.** Una empresa habilitada como plataforma crea cobros para sus comercios conectados con su propia llave y la cabecera `Lane-On-Behalf-Of`, los invita con enlaces de registro (`/v1/platform/signup-links`), los lista (`/v1/platform/merchants`) y recibe sus avisos con `connected_merchant_id`. [Ver más](https://lane.money/docs/guias/plataformas)
- **Nuevo · Plataformas: Página de pago con todos los medios y productos extra.** El cobro que crea una plataforma va a una página de Lane donde el comprador elige entre tarjeta, PSE, Nequi, Daviplata y Bre-B. Acepta `line_items` para mostrar el pedido, `extra_items` para ofrecer hasta tres productos más y `available_payment_methods` para limitar los medios. [Ver más](https://lane.money/docs/plataformas/cobros)
- **Nuevo · API: `Idempotency-Key` al crear cobros y enlaces.** `POST /v1/checkout/sessions`, `POST /v1/payment_links` y `POST /v1/platform/signup-links` aceptan la cabecera: la misma petición con la misma clave, en las 24 horas siguientes, responde lo mismo que la primera, con `Idempotent-Replayed: true`. [Ver más](https://lane.money/docs/errores)
- **Cambio · Webhooks: Cada endpoint recibe solo los eventos de su modo.** Un endpoint se registra en modo Prueba o Real y recibe únicamente los eventos de ese modo; el evento trae `environment`. Para recibir los dos, registra un endpoint en cada modo. [Ver más](https://lane.money/docs/webhooks)
- **Cambio · API: Un cobro puede durar hasta un año.** `expires_in` acepta entre `60` y `31536000` segundos, y la sesión vive lo mismo que la página a la que apunta. Por defecto siguen siendo 12 horas. [Ver más](https://lane.money/docs/api/sesiones)