> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Changelog de la API

> Últimas actualizaciones e historial de versiones de la API de Yuno

## v2026-11

*10 de noviembre de 2026*

**Payments**

* ADDED **Aprobaciones parciales en pagos con tarjeta**\
  Crear pago acepta un nuevo campo opcional `payment_method.detail.card.partial_approval` (valor predeterminado `false`) en compras y autorizaciones con tarjeta; se ignora en verify. Con `true`, el pago puede aprobarse por menos de `amount.value`. Un nuevo `amount.authorized` en el objeto de pago, las respuestas de las operaciones y los webhooks de pago devuelve el monto que aprobó el proveedor, neto de cualquier promoción de Yuno y aumentado por las autorizaciones incrementales aprobadas; después de una aprobación parcial, el pago conserva el estado de una aprobación completa, por lo que está aprobado parcialmente cuando `amount.authorized` es menor que `amount.value` menos `discount_amount` (cuando no hay promoción, menor que `amount.value`). Para un pago aprobado parcialmente, una captura sin `amount` captura `amount.authorized`, una captura por encima de ese monto se rechaza con `400 INVALID_PARAMETERS` y los reembolsos se limitan a él. Los pagos enviados sin el campo, o procesados por un proveedor que no admite aprobaciones parciales, se comportan exactamente como antes.
  *Ver también: [El objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md), [Crear un pago](https://docs.y.uno/es/reference/payments/create-payment.md), [Capturar autorización](https://docs.y.uno/es/reference/payments/capture-authorization.md)*

*5 de noviembre de 2026*

**Payments**

* CHANGED **Número de teléfono del pagador enmascarado para algunos proveedores y países**\
  Donde el enmascaramiento está habilitado para un proveedor y país (debido a normas locales de protección de datos), `customer_payer.phone.number` en la respuesta del pago puede devolverse enmascarado, y muestra solo los últimos cuatro dígitos (por ejemplo, `*****3456`). En el resto de los casos, el número completo se devuelve como antes. Un valor enmascarado no es un número de teléfono válido: no lo envíes de nuevo en solicitudes posteriores (reembolsos, cancelaciones o nuevos pagos).
  *Ver también: [El objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md), [Consultar pago por ID](https://docs.y.uno/es/reference/payments/retrieve-payment-by-id-v2.md)*

## v2026-10

*19 de octubre de 2026*

**Payments**

* ADDED **Condiciones de moneda en el enrutamiento con NOT\_EQUAL, ONE\_OF y NOT\_ONE\_OF**\
  Las condiciones de enrutamiento aceptan `CURRENCY` con `EQUAL`, `NOT_EQUAL`, `ONE_OF` o `NOT_ONE_OF` y las monedas en `values` (ISO 4217 en mayúsculas, sin el campo `currency`), de modo que un enrutamiento puede coincidir con "la moneda no es USD" o "la moneda es EUR o GBP" a través de la API. Retrieve a Routing y List Routings devuelven `NOT_EQUAL`, `ONE_OF` y `NOT_ONE_OF` tal como se enviaron; `CURRENCY` con `EQUAL` se devuelve como la condición `AMOUNT` solo de moneda. Las condiciones de moneda creadas en el Dashboard sin un monto ahora pueden actualizarse a través de la API.
  *Ver también: [Condiciones de enrutamiento](https://docs.y.uno/es/reference/organizations/routing/routing-conditions.md)*

* FIXED **Grupos de Merchant Advice Code devueltos como `DECLINE_GROUP` en la API de enrutamiento**\
  Update a Routing y Create a Routing aceptan una salida `DECLINE_GROUP` que hace referencia a un grupo de Merchant Advice Code, el formato que guarda el Dashboard y que devuelve Retrieve a Routing, de modo que un ciclo de obtener y actualizar de esos enrutamientos ya no falla con `400 INVALID_ROUTE_CONFIGURATION`. El estado se conserva tal como se envió, y `DECLINE_GROUP` y `MAC_CODE_GROUP` coinciden con los rechazos de forma distinta. `retry: true` en una entrada de este tipo se acepta solo cuando el enrutamiento almacenado ya reintenta ese grupo.
  *Ver también: [Forma del recurso de enrutamiento](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#outcome-groups)*

* ADDED **Nonce del proveedor en pagos directos con billetera**\
  `POST /v1/payments` acepta un nuevo campo opcional `payment_method.detail.wallet.provider_payment_token` en el flujo de trabajo `DIRECT`: un nonce de un solo uso del SDK de cliente del proveedor, como un nonce de Braintree PayPal. Yuno lo reenvía a la conexión del proveedor y no lo almacena. Combinado con `vault_on_success`, el pago devuelve un `vaulted_token`, y las respuestas de creación y de Retrieve Payment devuelven el ID almacenado en la bóveda del proveedor en `payment_method.payment_method_detail.wallet.provider_token` (también en Retrieve Payment Method como `provider.token`). `wallet.provider_token` se devuelve para los pagos `PAYPAL_BRAINTREE` cuando Braintree guardó la cuenta en su bóveda, y se omite en caso contrario. El campo se rechaza con `400 INVALID_REQUEST` en otros flujos de trabajo, cuando está en blanco o cuando se combina con otro token de billetera o de método de pago. Las solicitudes sin este campo se comportan exactamente igual que antes.
  *Ver también: [PayPal y Venmo](https://docs.y.uno/es/docs/wallets/paypal.md#direct-integration-with-a-braintree-nonce), [Crear un pago](https://docs.y.uno/es/reference/payments/create-payment.md)*

* ADDED **Grupos de resultado, reintento y pasos de acción en la API de enrutamiento**\
  Las salidas de enrutamiento aceptan `MAC_CODE_GROUP` y `SUCCEEDED_GROUP` junto con `DECLINE_GROUP`, hacen referencia a los grupos de la cuenta mediante `group_id` y llevan `retry` para intentar una vez más con el mismo proveedor antes del respaldo. Los pasos aceptan `action` `CAPTURE` (con `action_delay`) y `HOLD_FOR_REVIEW` después de una salida `APPROVED` o `SUCCEEDED_GROUP`, junto con `CANCEL`. Dos endpoints de solo lectura, `GET /v1/routing/decline-groups` y `GET /v1/routing/succeeded-groups`, listan los grupos de una cuenta. Retrieve a Routing devuelve `retry`, `group_id`, `group_name`, `action` y `action_delay`, de modo que un ciclo de obtener y actualizar conserva el enrutamiento tal como está configurado en el Dashboard.
  *Ver también: [Forma del recurso de enrutamiento](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md), [Listar grupos de rechazo](https://docs.y.uno/es/reference/organizations/routing/list-decline-groups.md), [Listar grupos de éxito](https://docs.y.uno/es/reference/organizations/routing/list-succeeded-groups.md)*

* ADDED **Pasos de fraude, 3DS y enrutamiento inteligente en la API de enrutamiento**\
  Ahora un paso de proveedor informa su `provider_type`; los pasos de fraude llevan su configuración (`fraud`: reglas, listas de bloqueo, listas de permitidos, listas de revisión, preset, `report_only`) y el resultado `PENDING`, en el que pueden ramificarse los pasos de fraude, 3DS y autenticación; `REVERT` es una acción final después de una verificación de fraude posterior al pago; y un paso de enrutamiento inteligente (`provider_id: "SMART_ROUTING"` con `smart_routing`) puede crearse, actualizarse y leerse en los enrutamientos de tarjeta. Junto con las entradas anteriores, un enrutamiento creado en el Dashboard puede leerse y volver a escribirse a través de la API sin pérdidas.
  *Ver también: [Forma del recurso de enrutamiento](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md)*

* ADDED **Network token y exenciones 3DS por paso de enrutamiento**\
  Los pasos de proveedor de un enrutamiento aceptan `network_token_on` en los proveedores de pago de un enrutamiento `CARD` y `three_d_secure_exemptions` en los proveedores 3DS, los ajustes por paso que el Dashboard ya almacena. Retrieve a Routing los devuelve junto con los campos de solo lectura `timeout` y `network_token_enable` de cada paso de proveedor. Al actualizar, un paso enviado sin uno de estos campos conserva el valor almacenado; `network_token_on: false` y `three_d_secure_exemptions: []` lo borran.
  *Ver también: [Forma del recurso de enrutamiento](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md), [Exenciones de SCA](https://docs.y.uno/es/docs/payment-features/sca-exemptions.md)*

* ADDED **Horarios, límites de volumen, campos adicionales y condiciones solo de moneda en el enrutamiento**\
  Las condiciones de enrutamiento admiten `TIME_PERIOD` (rango de fechas con recurrencia, días de la semana y una ventana horaria), `VOLUME_PAYMENTS_LIMIT` (cantidad de pagos o límite de volumen por día, mes o trimestre, con `limit_by` y `payments_count`) y `ADDITIONAL_FIELD` (campos de cliente, dirección, orden, aerolínea y tarjeta por `key`). Una condición `AMOUNT` con `currency` y una lista `values` vacía coincide con cualquier monto en esa moneda. Los campos de horario y límite se devuelven al obtener el enrutamiento y se conservan al actualizar.
  *Ver también: [Condiciones de enrutamiento](https://docs.y.uno/es/reference/organizations/routing/routing-conditions.md)*

* ADDED **ID de recomendación en las transacciones reportadas**\
  `POST /v1/reporting/transactions` acepta un nuevo campo opcional `recommendation_id` en cada evento: el valor devuelto por `POST /v1/routing/recommendations` para ese pago, como un UUID v4 en minúsculas. Yuno lo almacena para atribuir el resultado reportado a esa recomendación; no se valida contra las recomendaciones existentes. Los eventos sin este campo se comportan exactamente igual que antes; cualquier otro valor se rechaza por evento con `INVALID_EVENT` y el mensaje "The field 'recommendation\_id' must be a UUID."
  *Ver también: [Reportar transacciones fuera de Yuno](https://docs.y.uno/es/reference/reporting/report-transactions.md)*

## v2026-09

*14 de septiembre de 2026*

**Payments**

* ADDED **Iniciación CIT/MIT en las transacciones reportadas**\
  `POST /v1/reporting/transactions` acepta un nuevo campo opcional `initiation` en cada evento: `CIT` (iniciada por el titular de la tarjeta) o `MIT` (iniciada por el comercio). Yuno lo guarda en el pago reportado y lo usa para construir estadísticas por nivel de iniciación. Los eventos sin este campo se comportan exactamente igual que antes; cualquier otro valor se rechaza por evento con `INVALID_EVENT` y el mensaje "The field 'initiation' must be CIT or MIT."
  *Ver también: [Reportar transacciones fuera de Yuno](https://docs.y.uno/es/reference/reporting/report-transactions.md)*

* CHANGED **Recomendaciones de enrutamiento por nivel de iniciación**\
  Ahora `POST /v1/routing/recommendations` clasifica a los candidatos en el segmento de la misma iniciación cuando `payment.initiation` coincide con el historial reportado: en cada nivel prueba primero el historial específico de la iniciación y, si no, recurre al nivel completo, de modo que una solicitud sin `payment.initiation` devuelve la misma clasificación que antes.
  *Ver también: [Obtener una recomendación de enrutamiento](https://docs.y.uno/es/reference/organizations/routing/get-routing-recommendations.md)*

## v2026-08

*31 de agosto de 2026*

**Seguridad**

* ADDED **Modo solo criptograma para la API de criptograma de Network Token**\
  Hay un nuevo campo opcional `include_network_token` (valor predeterminado `true`) disponible en `POST /v1/network-tokens/cryptograms`. Con `false`, la respuesta omite `network_token.number` (DPAN) y `network_token.token_data` y conserva los metadatos que no equivalen a un PAN, de modo que los comercios sin certificación PCI pueden realizar pagos con network token combinando el criptograma con el PCI Proxy, que resuelve el DPAN en el momento del reenvío.
  *Ver también: [Generar un criptograma de network token](https://docs.y.uno/es/reference/network-tokens/generate-network-token-cryptogram.md)*

* CHANGED **Error explícito para organizaciones sin PCI que solicitan el network token**\
  En `POST /v1/network-tokens/cryptograms`, una organización sin certificación PCI que solicita el network token completo (`include_network_token` en `true` u omitido) ahora recibe `403 NETWORK_TOKEN_RETURN_NOT_ALLOWED` con una guía para usar el modo solo criptograma, en lugar del genérico `PCI_MERCHANT_REQUIRED`.
  *Ver también: [Generar un criptograma de network token](https://docs.y.uno/es/reference/network-tokens/generate-network-token-cryptogram.md)*

**Payments**

* ADDED **BIN de tarjeta en las transacciones reportadas**\
  `POST /v1/reporting/transactions` acepta un nuevo campo opcional `payment_method_details.card.bin` en los eventos `CARD`: el BIN de la tarjeta, de exactamente 6 u 8 dígitos. Yuno lo guarda en el pago reportado y lo usa para construir estadísticas por BIN. Los eventos sin este campo se comportan exactamente igual que antes; un valor que no tenga 6 u 8 dígitos se rechaza por evento con `INVALID_EVENT`.
  *Ver también: [Reportar transacciones fuera de Yuno](https://docs.y.uno/es/reference/reporting/report-transactions.md)*

* CHANGED **Recomendaciones de enrutamiento por BIN**\
  Ahora `POST /v1/routing/recommendations` clasifica a los candidatos en el segmento del BIN cuando `payment.payment_method.details.card.bin` coincide con el historial reportado (primero el BIN de 8 dígitos y luego el de 6) y, si no, recurre a los segmentos de país y método de pago, de modo que un BIN sin historial devuelve la misma clasificación que antes.
  *Ver también: [Obtener una recomendación de enrutamiento](https://docs.y.uno/es/reference/organizations/routing/get-routing-recommendations.md)*

## v2026-07

*11 de julio de 2026*

**Seguridad**

* ADDED **PCI Proxy**\
  Ahora puedes enviar datos de tarjetas almacenadas a cualquier API de terceros a través del entorno PCI DSS Nivel 1 de Yuno, mediante el nuevo endpoint `/v1/pci-proxy/forward`, sin incorporar tus sistemas al alcance de PCI.
  *Ver también: [Resumen de PCI Proxy](https://docs.y.uno/es/docs/security-and-compliance/pci-proxy/overview.md)*

## v2025-06

*30 de junio de 2025*

* CHANGED **Nombre y apellido opcionales para los clientes**\
  Los campos `first_name` y `last_name` ahora son opcionales al crear un cliente mediante la API. Si un proveedor de pagos los requiere, el formulario del SDK se los pedirá al usuario. Si no usas el SDK de Yuno, asegúrate de enviar estos campos al crear el pago cuando el proveedor los requiera.
  *Ver también: [Referencia de Crear un cliente](https://docs.y.uno/es/reference/customers/create-customer.md)*

**Seguridad**

* ADDED **Compatibilidad con exenciones de SCA en 3DS**\
  Hay un nuevo campo opcional `strong_customer_authentication_exemptions` disponible en `payment_method.detail.card.three_d_secure`. Además, Yuno propaga las recomendaciones de exención de tu proveedor de fraude a lo largo de toda la ruta de pago hasta el gateway 3DS, y el tipo de exención aparece en la respuesta del pago, en la API GET y en los webhooks.
  *Ver también: [Guía de exenciones de SCA](https://docs.y.uno/es/docs/payment-features/sca-exemptions.md)*

**Payments**

* ADDED **Campo de tipo de viaje de aerolínea**\
  Se agregó un nuevo campo enum `type` dentro de `additional_data.airline` para especificar el tipo de viaje: `ONE_WAY`, `ROUNDTRIP` o `MULTIPLE_DESTINATIONS`. No se requieren cambios en la integración si no usas datos de aerolínea.
  *Ver también: [Referencia de Crear un pago](https://docs.y.uno/es/reference/payments/create-payment.md)*

* ADDED **Campos de orden de tramos de aerolínea**\
  Se agregaron dos nuevos campos enteros, `order` y `route_order`, dentro de `additional_data.airline.legs` para describir el orden de los tramos dentro de una ruta y entre rutas, respectivamente. No se requieren cambios en la integración si no usas datos de tramos de aerolínea.
  *Ver también: [Referencia de Crear un pago](https://docs.y.uno/es/reference/payments/create-payment.md)*

* ADDED **Estructura de datos de transporte**\
  Hay un nuevo arreglo `transportations` de objetos disponible dentro de `additional_data` para reservas de viaje que no son de aerolínea, como autobús, tren, barco, tranvía y automóvil. Cada entrada admite los subobjetos legs, passengers y tickets con detalles de salida y llegada.
  *Ver también: [Referencia de Crear un pago](https://docs.y.uno/es/reference/payments/create-payment.md)*

## v2025-05

*31 de mayo de 2025*

**Seguridad**

* CHANGED **Inscripción de network tokens para tarjetas guardadas en la bóveda**\
  Cuando la funcionalidad de network tokens está habilitada, Yuno ahora genera network tokens para todas las tarjetas inscritas y almacenadas en la bóveda. Las tarjetas de un solo uso quedan excluidas. Esto se alinea con los estándares de tokenización de red de Visa y Mastercard y mejora la seguridad y la confiabilidad de los pagos recurrentes.
  *Ver también: [Guía de network tokens](https://docs.y.uno/es/docs/security-and-compliance/network-tokens.md)*

**Suscripciones**

* ADDED **Control de la fecha de facturación de la suscripción**\
  Hay una nueva estructura `billing_date` disponible al crear una suscripción, que te permite definir el momento de la facturación como `PREPAID`, `POSTDATE` o un `DAY` específico del mes. Este campo es mutuamente excluyente con el objeto `frequency`.
  *Ver también: [Guía de suscripciones](https://docs.y.uno/es/docs/payment-features/subscriptions.md)*

**Payments**

* ADDED **Campo de fecha de vencimiento del método de pago**\
  Ahora se devuelve un nuevo campo de marca de tiempo `expirates_at` dentro de `payment_method_detail.wallet` para los métodos de pago asíncronos que lo admiten. La disponibilidad depende de la compatibilidad del proveedor.
  *Ver también: [Referencia de Crear un pago](https://docs.y.uno/es/reference/payments/create-payment.md)*

> [accordion] expirates\_at en la respuesta de wallet
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "payment_method": {
>   "type": "NU_PAY",
>   "payment_method_detail": {
>     "wallet": {
>       "expirates_at": "2025-05-14T15:06:48.383418Z"
>     }
>   }
> }
> ```

* ADDED **Geolocalización del cliente en los pagos**\
  Ahora hay un nuevo objeto `geolocation` con los campos `latitude` y `longitude` disponible dentro de `customer_payer` al crear un pago.
  *Ver también: [Referencia de Crear un pago](https://docs.y.uno/es/reference/payments/create-payment.md)*

> [accordion] geolocation en customer\_payer
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "customer_payer": {
>   "id": "b080db73-b12d-4710-a604-d659bce26f01",
>   "geolocation": {
>     "latitude": "-34.4720",
>     "longitude": "-58.5300"
>   }
> }
> ```

* ADDED **Cancelar pagos APM en estado PENDING**\
  Ahora puedes cancelar mediante el endpoint de cancelación un pago `PENDING` creado con un método de pago alternativo (APM). Antes esto estaba restringido solo a las transacciones con tarjeta. La disponibilidad de la funcionalidad depende de la compatibilidad del proveedor.
  *Ver también: [Referencia de Cancelar un pago](https://docs.y.uno/es/reference/payments/cancel-payment.md)*

**Webhooks**

* ADDED **Compatibilidad con URL de webhook para suscripciones**\
  Ahora puedes definir un `webhook_url` en la sección Developers del Dashboard para recibir los eventos del ciclo de vida de las suscripciones. Los distintos tipos de evento producen payloads de webhook distintos.
  *Ver también: [Documentación de webhooks](https://docs.y.uno/es/docs/webhooks/configure-webhooks.md)*

## v2025-04

*30 de abril de 2025*

**Seguridad**

* CHANGED **Servicio de setup de 3DS eliminado**\
  Ya no se requiere la llamada separada al servicio de setup para la implementación directa de 3DS. La recopilación de datos y el setup ahora se manejan automáticamente dentro de la creación del pago, lo que simplifica el flujo de integración.
  *Ver también: [Guía de 3D Secure](https://docs.y.uno/es/docs/security-and-compliance/3d-secure.md)*

**Payments**

* ADDED **Campos extendidos de tramos de aerolínea**\
  Se agregaron nuevos campos dentro de `additional_data.airline.legs`: `arrival_airport_country`, `arrival_airport_city`, `departure_airport_country` y `departure_airport_city`. Además, ahora hay un `booking_system_code` y un `booking_system_name` disponibles dentro de `airline.tickets[].issue`. No se requieren cambios en la integración si no usas datos de aerolínea.
  *Ver también: [Referencia de Crear un pago](https://docs.y.uno/es/reference/payments/create-payment.md)*

> [accordion] Tramos de aerolínea con nuevos campos
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "additional_data": {
>   "airline": {
>     "legs": [
>       {
>         "arrival_airport": "AMS",
>         "arrival_airport_country": "AR",
>         "arrival_airport_city": "BUE",
>         "departure_airport": "EZE",
>         "departure_airport_country": "AR",
>         "departure_airport_city": "BUE"
>       }
>     ],
>     "tickets": [
>       {
>         "issue": {
>           "booking_system_code": "TT01",
>           "booking_system_name": "booking system"
>         }
>       }
>     ]
>   }
> }
> ```

## v2025-03

*31 de marzo de 2025*

**Payments**

* ADDED **Arreglo de descuentos en los datos de la orden**\
  Hay un nuevo arreglo `discounts` de objetos disponible dentro de `additional_data.order`. Cada descuento admite los campos `id`, `name` y `unit_amount`.
  *Ver también: [Guía de detalles del monto del pago](https://docs.y.uno/es/docs/payment-features/payment-amount-details.md#discounts)*

> [accordion] discounts en additional\_data.order
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "additional_data": {
>   "order": {
>     "discounts": [
>       {
>         "id": "XYZ",
>         "name": "Offer",
>         "unit_amount": "100"
>       }
>     ]
>   }
> }
> ```

* ADDED **Indicador de monitores en las reglas de enrutamiento**\
  Se agregó un nuevo campo booleano `monitors` dentro del objeto `routing_rules` en la respuesta del pago, que indica si una transacción se procesó mediante la función Monitors. No se requieren cambios en la integración.
  *Ver también: [Referencia del objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md)*

> [accordion] monitors en la respuesta de routing\_rules
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "routing_rules": {
>   "smart_routing": false,
>   "monitors": true,
>   "condition": {
>     "id": 133892,
>     "name": null,
>     "description": null
>   }
> }
> ```

**Reembolsos**

* ADDED **Información del cliente en solicitudes de reembolso**\
  Las solicitudes de reembolso ahora aceptan un nuevo objeto `customer_payer`, que te permite enviar datos adicionales del cliente (por ejemplo, `document`) a los proveedores que los requieren.
  *Ver también: [Referencia de reembolso de pago](https://docs.y.uno/es/reference/payments/refund-payment.md)*

> [accordion] customer\_payer en la solicitud de reembolso
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> {
>   "description": "Duplicate",
>   "reason": "REQUESTED_BY_CUSTOMER",
>   "merchant_reference": "AAB01-432245",
>   "customer_payer": {
>     "document": {
>       "document_type": "DNI",
>       "document_number": "38919283"
>     }
>   }
> }
> ```

## v2025-02

*28 de febrero de 2025*

**Webhooks**

* ADDED **Autenticación OAuth2 para webhooks**\
  Los webhooks ahora admiten autenticación OAuth2. Configura `authentication_url`, `client_secret_key`, `client_id` y `grant_type` en la sección Developers/Webhooks del dashboard para que Yuno pueda obtener tokens y entregar los webhooks de forma segura.
  *Ver también: [Guía de configuración de webhooks](https://docs.y.uno/es/docs/webhooks/configure-webhooks.md)*

* ADDED **URL dedicada para webhooks de contracargos**\
  Ahora puedes configurar una URL de webhook dedicada específicamente para los eventos de contracargo. Antes, los contracargos se enviaban junto con el trigger Purchase. Actualiza la configuración de tus webhooks en el dashboard para usar la nueva URL dedicada de contracargos.
  *Ver también: [Guía de configuración de webhooks](https://docs.y.uno/es/docs/webhooks/configure-webhooks.md)*

## v2025-01

*31 de enero de 2025*

**Payments**

* ADDED **Datos de boletos en las órdenes de pago**\
  Un nuevo arreglo de objetos `tickets` está disponible dentro de `additional_data.order`, con campos como `id`, `name`, `description`, `type`, `amount` y un objeto anidado `event` con los detalles de la dirección.
  *Ver también: [Referencia de la API de pagos](https://docs.y.uno/es/reference/payments/status-and-response-codes/payment.md)*

> [accordion] tickets en additional\_data.order
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "additional_data": {
>   "order": {
>     "tickets": [
>       {
>         "id": "XYZ",
>         "name": "Music",
>         "type": "VIRTUAL",
>         "amount": {
>           "currency": "COP",
>           "value": 5000
>         },
>         "event": {
>           "id": "ADMKASLMD",
>           "name": "Music festival",
>           "type": "FESTIVAL",
>           "date": "1990-02-28"
>         }
>       }
>     ]
>   }
> }
> ```

**Suscripciones**

* ADDED **Validación del pago inicial de la suscripción**\
  Un nuevo campo booleano `initial_payment_validation` está disponible al crear una suscripción. Configúralo en `true` para continuar la suscripción solo después de un primer pago exitoso, o en `false` para continuar sin importar el resultado del primer pago.
  *Ver también: [Referencia de creación de suscripción](https://docs.y.uno/es/reference/subscriptions/create-subscription.md)*

> [accordion] initial\_payment\_validation en la suscripción
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> {
>   "initial_payment_validation": true
> }
> ```

## v2024-12

*31 de diciembre de 2024*

**Payments**

* ADDED **Selección del tipo de tarjeta para tokens de la bóveda**\
  Al usar un token almacenado en la bóveda para un pago, ahora puedes especificar `card_data.type` como `CREDIT` o `DEBIT` dentro de `payment_method.detail.card`. Es útil en mercados como Brasil, donde la misma tarjeta puede usarse para ambos tipos de transacción.
  *Ver también: [Referencia de la API de pagos](https://docs.y.uno/es/reference/payments/create-payment.md)*

> [accordion] Especificar DEBIT o CREDIT para un token de la bóveda
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "payment_method": {
>   "type": "CARD",
>   "vaulted_token": "e2961d37-9898-4bac-8408-cc9f02c11cc2",
>   "detail": {
>     "card": {
>       "card_data": {
>         "type": "DEBIT"
>       }
>     }
>   }
> }
> ```

* ADDED **Detalles de la transacción de fondeo de cuenta**\
  Un nuevo objeto `account_funding` está disponible dentro de `additional_data`, con los subobjetos `sender` y `beneficiary` que incluyen los campos de nombre, correo electrónico y documento requeridos para las transacciones de fondeo de cuenta (AFT).
  *Ver también: [Guía de AFT](https://docs.y.uno/es/docs/payment-features/account-funding-transactions-afts.md)*

> [accordion] account\_funding en additional\_data
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "additional_data": {
>   "account_funding": {
>     "sender": {
>       "first_name": "John",
>       "last_name": "Doe",
>       "email": "john.doe@mail.com"
>     },
>     "beneficiary": {
>       "first_name": "Chris",
>       "last_name": "Martin",
>       "document": {
>         "document_number": "38192019",
>         "document_type": "CC"
>       }
>     }
>   }
> }
> ```

* ADDED **ID de transacción de red para credenciales almacenadas**\
  Un nuevo campo `network_transaction_id` está disponible dentro de `payment_method.detail.card.stored_credentials`. Se recomienda para pagos de suscripciones con tarjetas inscritas, para garantizar la trazabilidad durante todo el ciclo de vida del pago.
  *Ver también: [Guía de credenciales almacenadas](https://docs.y.uno/es/docs/payment-features/stored-credentials.md)*

> [accordion] network\_transaction\_id en stored\_credentials
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "payment_method": {
>   "type": "CARD",
>   "vaulted_token": "eb8caa17-6407-457b-960e-125d8d7a90c1",
>   "detail": {
>     "card": {
>       "stored_credentials": {
>         "reason": "CARD_ON_FILE",
>         "usage": "USED",
>         "network_transaction_id": "583103536844189"
>       }
>     }
>   }
> }
> ```

* ADDED **Indicador de enrutamiento inteligente en la respuesta del pago**\
  Se agregó un nuevo campo booleano `smart_routing` dentro del objeto `routing_rules` en la respuesta del pago, que indica si la transacción se procesó mediante la función de enrutamiento inteligente. No se requieren cambios en la integración.
  *Ver también: [Referencia de la API de pagos](https://docs.y.uno/es/reference/payments/create-payment.md)*

> [accordion] smart\_routing en la respuesta de routing\_rules
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "routing_rules": {
>   "smart_routing": false,
>   "condition": {
>     "id": 133892,
>     "name": null,
>     "description": null
>   }
> }
> ```

**Suscripciones**

* ADDED **Periodo de prueba para suscripciones**\
  Un nuevo objeto `trial_period` está disponible al crear una suscripción. Define `billing_cycles` y un `amount` reducido para ofrecer periodos de prueba parciales o totales (gratuitos) antes de que comience la facturación completa.
  *Ver también: [Referencia de creación de suscripción](https://docs.y.uno/es/reference/subscriptions/create-subscription.md)*

> [accordion] trial\_period en la solicitud de suscripción
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "trial_period": {
>   "billing_cycles": "1",
>   "amount": {
>     "currency": "COP",
>     "value": 2500
>   }
> }
> ```

## v2024-11

*30 de noviembre de 2024*

**Payments**

* ADDED **Campos de vencimiento de la tarjeta en la respuesta de la transacción**\
  Ahora se devuelven dos campos nuevos, `expiration_month` y `expiration_year`, dentro de `transactions.card_data` en la respuesta del pago. No se requieren cambios en la integración.
  *Ver también: [Referencia del objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md)*

> [accordion] expiration\_month y expiration\_year en card\_data
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "card_data": {
>   "holder_name": "Paco",
>   "iin": "48710499",
>   "brand": "VISA",
>   "fingerprint": "71000db4-f8e7-4ea0-a2cc-9d9ebb76a955",
>   "expiration_month": 3,
>   "expiration_year": 30
> }
> ```

* ADDED **Destinatarios para pagos divididos en marketplace**\
  Una nueva API de destinatarios (Recipients) te permite registrar destinatarios con varias asignaciones de proveedores antes de enviar pagos divididos. Usa `recipient_id` en el arreglo `split_marketplace` en lugar de los IDs específicos de cada proveedor cuando intervienen varios proveedores.
  *Ver también: [Guía de pagos divididos en marketplace](https://docs.y.uno/es/docs/payment-features/split-payments-marketplace.md)*

> [accordion] Usar recipient\_id en split\_marketplace
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "split_marketplace": [
>   {
>     "amount": { "currency": "BRL", "value": 500 },
>     "recipient_id": "09d8bad7-4efe-47e2-b9ee-f4028460bab1",
>     "type": "PURCHASE"
>   },
>   {
>     "amount": { "currency": "BRL", "value": 500 },
>     "recipient_id": "d94e02c1-cc47-4e60-a20a-2b17fe58992d",
>     "type": "PURCHASE"
>   }
> ]
> ```

**Reembolsos**

* ADDED **Compatibilidad con comprobantes en transacciones de reembolso**\
  Las solicitudes de reembolso ahora aceptan un booleano `response_additional_data.receipt` y un campo opcional `receipt_language`. Cuando se configuran, se devuelve una URL del comprobante en `payment.transaction.receipt_url` después de procesar el reembolso.
  *Ver también: [Referencia de reembolso de pago](https://docs.y.uno/es/reference/payments/refund-payment.md)*

> [accordion] Solicitar un comprobante en un reembolso
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> {
>   "description": "Duplicate",
>   "reason": "REQUESTED_BY_CUSTOMER",
>   "merchant_reference": "AAB01-432245",
>   "response_additional_data": {
>     "receipt": true,
>     "receipt_language": "ES"
>   }
> }
> ```

**Suscripciones**

* ADDED **Datos de artículos para suscripciones**\
  Ahora hay un nuevo arreglo `additional_data.order.items` disponible al crear una suscripción, que te permite enviar a los proveedores detalles a nivel de artículo (category, id, name, quantity, unit\_amount).
  *Ver también: [Referencia de creación de suscripción](https://docs.y.uno/es/reference/subscriptions/create-subscription.md)*

> [accordion] items en additional\_data de la suscripción
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "additional_data": {
>   "order": {
>     "items": [
>       {
>         "category": "art",
>         "id": "AA01",
>         "name": "Test item",
>         "quantity": 1,
>         "unit_amount": 10
>       }
>     ]
>   }
> }
> ```

**Payouts**

* ADDED **Payouts a tokens almacenados en la bóveda**\
  La API de Payouts ahora permite enviar payouts directamente a tarjetas de crédito o débito inscritas, mediante un `vaulted_token` dentro de `withdrawal_method`. Requiere compatibilidad del proveedor.
  *Ver también: [Referencia de creación de payout](https://docs.y.uno/es/reference/payouts/create-payout.md)*

> [accordion] Payout a una tarjeta inscrita
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "withdrawal_method": {
>   "type": "CARD",
>   "provider_id": "UNLIMINT",
>   "vaulted_token": "your-vaulted-token"
> }
> ```

## v2024-10

*31 de octubre de 2024*

**Suscripciones**

* ADDED **Esquema de reintentos inteligentes para suscripciones**\
  Las transacciones rechazadas de suscripciones ahora admiten reintentos inteligentes (Smart Retries), que usan aprendizaje automático para determinar el momento óptimo de cada reintento. El calendario de reintentos consta de siete intentos en 96 horas. Se configura desde el dashboard de Suscripciones.
  *Ver también: [Guía de reintentos de transacciones](https://docs.y.uno/es/docs/payment-features/transaction-retries.md)*

**Payments**

* ADDED **Campo del tipo de método de pago principal**\
  Se devuelve un nuevo campo `parent_payment_method_type` dentro de `transactions.payment_method`, que indica el proveedor de billetera (`APPLE_PAY`, `GOOGLE_PAY` o `CLICK_TO_PAY`) usado en una integración directa de billetera. No se requieren cambios en la integración.
  *Ver también: [Referencia del objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md)*

> [accordion] parent\_payment\_method\_type en la transacción
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "transactions": {
>   "payment_method": {
>     "vaulted_token": "29b44e45-57fe-41b0-81c8-586deeb699b2",
>     "type": "CARD",
>     "parent_payment_method_type": "CLICK_TO_PAY"
>   }
> }
> ```

* ADDED **ID de conexión en los datos de la transacción**\
  Se devuelve un nuevo campo `connection_data.id` dentro de cada objeto de transacción, con el identificador único de la conexión de pago usada para procesar la transacción. No se requieren cambios en la integración.
  *Ver también: [Referencia del objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md)*

> [accordion] connection\_data.id en la transacción
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "connection_data": {
>   "id": "88292fd3-bf5b-4b23-bb95-7186ba4e7f88"
> }
> ```

* ADDED **Compatibilidad con comprobantes en transacciones de cancelación**\
  Las solicitudes de cancelación ahora aceptan un booleano `response_additional_data.receipt`. Cuando se configura, se devuelve una URL del comprobante en `payment.transaction.receipt_url` después de procesar la cancelación.
  *Ver también: [Referencia de Cancelar un pago](https://docs.y.uno/es/reference/payments/cancel-payment.md)*

> [accordion] Solicitar un comprobante en una cancelación
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> {
>   "description": "Duplicate",
>   "reason": "REQUESTED_BY_CUSTOMER",
>   "merchant_reference": "AAB01-432245",
>   "response_additional_data": {
>     "receipt": true
>   }
> }
> ```

* ADDED **Objeto de envío en la solicitud de pago**\
  Un nuevo objeto `shipping` está disponible al crear un pago, con los campos `type`, `description`, `carrier` y `deliver_at` para especificar los detalles del envío.
  *Ver también: [Referencia del objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md)*

> [accordion] shipping en la solicitud de pago
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "shipping": {
>   "type": "STANDARD",
>   "description": "Test shipment",
>   "carrier": "UPS",
>   "deliver_at": "2024-09-17T20:43:54.786342Z"
> }
> ```

## v2024-09

*30 de septiembre de 2024*

**Payments**

* ADDED **Flujo de inscripción con enlaces de pago**\
  Los enlaces de pago ahora admiten la inscripción de tarjetas tras un pago exitoso. Configura `one_time_use=true` y `vault_on_success=true` al crear un enlace de pago para generar un nuevo `vaulted_token` para el cliente cuando el pago sea exitoso.
  *Ver también: [Guía para inscribir tarjetas con enlaces de pago](https://docs.y.uno/es/docs/payment-features/enrollment/enroll-cards-with-payment-link.md)*

* ADDED **Pagos divididos en marketplace**\
  Un nuevo arreglo `split_marketplace` está disponible en la solicitud de pago, que permite a los comercios dividir un pago entre varios destinatarios con montos, tipos (`PURCHASE`, `COMMISSION`) y configuraciones de responsabilidad personalizables. Requiere compatibilidad del proveedor.
  *Ver también: [Guía de split marketplace](https://docs.y.uno/es/docs/payment-features/split-payments-marketplace.md)*

> [accordion] split\_marketplace en la solicitud de pago
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "split_marketplace": [
>   {
>     "provider_recipient_id": "recipient_123",
>     "type": "PURCHASE",
>     "amount": { "value": 7500, "currency": "COP" },
>     "liability": {
>       "processing_fee": "MERCHANT",
>       "chargebacks": false
>     }
>   },
>   {
>     "provider_recipient_id": "recipient_456",
>     "type": "COMMISSION",
>     "amount": { "percentage": 30, "currency": "COP" },
>     "liability": {
>       "processing_fee": "RECIPIENT",
>       "chargebacks": true
>     }
>   }
> ]
> ```

## v2024-08

*31 de agosto de 2024*

**Suscripciones**

* ADDED **Campo de ID del acuerdo de suscripción**\
  Un nuevo campo `subscription_agreement_id` está disponible dentro de `payment_method.detail.card.stored_credentials`. Algunos mercados y procesadores (por ejemplo, México) lo requieren para incluir el ID del acuerdo con el cliente en los pagos relacionados con suscripciones.
  *Ver también: [Guía de credenciales almacenadas](https://docs.y.uno/es/docs/payment-features/stored-credentials.md#subscription-agreement)*

> [accordion] subscription\_agreement\_id en stored\_credentials
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "payment_method": {
>   "type": "CARD",
>   "vaulted_token": "eb8caa17-6407-457b-960e-125d8d7a90c1",
>   "detail": {
>     "card": {
>       "stored_credentials": {
>         "reason": "CARD_ON_FILE",
>         "usage": "USED",
>         "subscription_agreement_id": "AA0001"
>       }
>     }
>   }
> }
> ```

**Payouts**

* ADDED **Payouts referenciados a partir de transacciones**\
  Los payouts a métodos de pago con tarjeta ahora admiten un campo `original_transaction_id` dentro de `withdrawal_method`, que permite a los comercios iniciar un payout con los datos de tarjeta de una transacción anterior sin necesidad de cumplir con PCI.
  *Ver también: [Guía de Payouts](https://docs.y.uno/es/docs/payouts-and-disputes/payouts.md)*

> [accordion] Payout que referencia una transacción original
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "withdrawal_method": {
>   "type": "STP_PAYOUT",
>   "provider_id": "STP",
>   "original_transaction_id": "9104911d-5df9-429e-8488-ad41abea1a4b"
> }
> ```

**Payments**

* ADDED **Conversión de moneda en los pagos**\
  Un nuevo objeto `currency_conversion` está disponible dentro de la estructura `amount`, que te permite enviar `provider_currency_conversion_id`, `cardholder_currency` y `cardholder_amount` para la liquidación en dos monedas. Contacta a tu gerente técnico de cuenta para habilitarlo.
  *Ver también: [Guía de conversión de moneda](https://docs.y.uno/es/docs/additional-services/currency-conversion.md)*

> [accordion] currency\_conversion en amount
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "amount": {
>   "currency": "COP",
>   "value": 5000,
>   "currency_conversion": {
>     "provider_currency_conversion_id": "AAA01SADOIAJSDLAKSJM",
>     "cardholder_currency": "ARS",
>     "cardholder_amount": 1146.55
>   }
> }
> ```

* ADDED **Código y mensaje de respuesta ISO 8583**\
  Ahora se devuelven dos campos nuevos, `iso8583_response_code` y `iso8583_response_message`, dentro de `transactions.provider_data`, con la respuesta ISO 8583 directa del proveedor. Los códigos ABECS también se incluyen en estos campos para los proveedores de Brasil.
  *Ver también: [Referencia del objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md)*

> [accordion] Campos iso8583 en provider\_data
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "provider_data": {
>   "id": "ADYEN",
>   "transaction_id": "FLX4WSXF7SFZDV65",
>   "iso8583_response_code": "05",
>   "iso8583_response_message": "Approved or completed successfully"
> }
> ```

* ADDED **Cancelar o reembolsar un pago por ID de pago**\
  Un nuevo endpoint te permite cancelar o reembolsar un pago enviando solo el `payment_id`, sin necesidad del `transaction_id`. El endpoint existente a nivel de transacción sigue disponible.
  *Ver también: [Referencia de cancelación o reembolso de pago](https://docs.y.uno/es/reference/payments/cancel-or-refund-a-payment.md)*

* CHANGED **El historial de transacciones pasa a ser opcional**\
  El arreglo `transactions_history` del objeto de pago ahora se completa solo cuando el pago se crea con `response_additional_data.transactions_history: true`. Cuando no se envía el indicador, los webhooks y las respuestas de pago entregan `transactions_history` como un arreglo vacío `[]` para mantener pequeño el tamaño de los payloads. Los eventos de contracargo siguen incluyendo automáticamente el historial completo.
  *Ver también: [Referencia del objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md) · [Objeto webhook y ejemplos](https://docs.y.uno/es/docs/webhooks/object-and-examples.md)*

## v2024-07

*31 de julio de 2024*

**Payments**

* ADDED **Criptograma de billetera para pagos nativos**\
  Un nuevo campo `cryptogram` está disponible dentro de `payment_method.detail.wallet` al crear un pago, lo que habilita integraciones directas con las API de Apple Pay y Google Pay sin usar el Yuno SDK.
  *Ver también: [Guía de integración directa de Apple Pay](https://docs.y.uno/es/docs/wallets/apple-pay/apple-pay-direct-integration.md)*

* ADDED **Arreglo de impuestos en los datos de la orden**\
  Un nuevo arreglo de objetos `taxes` está disponible dentro de `additional_data.order`, que admite varias líneas de impuestos por pago. El objeto `tax` anterior de nivel superior sigue siendo compatible, pero se recomienda el nuevo arreglo para una mejor gestión de impuestos.
  *Ver también: [Guía de detalles del monto del pago](https://docs.y.uno/es/docs/payment-features/payment-amount-details.md#taxes)*

**Reembolsos**

* ADDED **Modo simplificado para reintentos de reembolso**\
  El indicador `simplified_mode: true` ahora es compatible en las solicitudes de reembolso. Yuno devolverá el estado `DECLINED` y reintentará el reembolso automáticamente hasta cinco veces en 24 horas, manteniendo el pago en estado `PENDING`/`RETRY_IN_PROCESS`.
  *Ver también: [Guía de reintentos de transacciones](https://docs.y.uno/es/docs/payment-features/transaction-retries.md)*

> [accordion] simplified\_mode en la solicitud de reembolso
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> {
>   "simplified_mode": true,
>   "reason": "REQUESTED_BY_CUSTOMER",
>   "merchant_reference": "AA01"
> }
> ```

## v2024-06

*30 de junio de 2024*

**Payouts**

* ADDED **Lanzamiento del producto Payouts**\
  Yuno Payouts ya está disponible como un nuevo producto de API para enviar fondos a beneficiarios (usuarios, comercios, proveedores, clientes) a través de bancos, tarjetas y billeteras, mediante varios proveedores. Consulta la documentación de Payouts para comenzar.
  *Ver también: [Guía de Payouts](https://docs.y.uno/es/docs/payouts-and-disputes/payouts.md)*

**Payments**

* ADDED **Campo fingerprint del método de pago**\
  Se devuelve un nuevo campo `fingerprint` en el objeto del método de pago y en la respuesta del pago para transacciones con tarjeta. Identifica de forma única una tarjeta entre varios `vaulted_tokens` dentro de tu organización.
  *Ver también: [Guía para inscribir métodos de pago](https://docs.y.uno/es/docs/payment-features/enrollment/enroll-payment-methods.md#step-5-retrieve-payment-methods)*

## v2024-05

*31 de mayo de 2024*

**Payments**

* ADDED **Modo simplificado para reintentos de captura**\
  Un nuevo booleano `simplified_mode` está disponible en las solicitudes de captura. Cuando se configura en `true`, Yuno devuelve de inmediato el estado `SUCCEEDED` y reintenta automáticamente las transacciones fallidas hasta cinco veces en un periodo de 24 horas.
  *Ver también: [Guía de reintentos de transacciones](https://docs.y.uno/es/docs/payment-features/transaction-retries.md)*

> [accordion] simplified\_mode en la solicitud de captura
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> {
>   "amount": { "currency": "COP", "value": "5000" },
>   "simplified_mode": true,
>   "reason": "PRODUCT_CONFIRMED",
>   "merchant_reference": "AA01"
> }
> ```

* ADDED **Campo de tipo de beneficio para pagos con Pluxee**\
  Se agregó un nuevo campo `benefity_type` al objeto de pago para el método de pago Pluxee en Chile. Es obligatorio al usar el flujo `DIRECT`.
  *Ver también: [Referencia del objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md)*

## v2024-04

*30 de abril de 2024*

* ADDED **Reglas de enrutamiento en la respuesta del pago**\
  Ahora se devuelve un nuevo objeto `routing_rules` en la respuesta del pago, con un subobjeto `condition` que contiene el `id`, el `name` y la `description` de la regla de enrutamiento aplicada durante la creación del pago. No se requieren cambios en la integración.
  *Ver también: [Referencia del objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md)*

> [accordion] routing\_rules en la respuesta del pago
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "routing_rules": {
>   "condition": {
>     "id": 76152,
>     "name": "PAYMENTS_COLOMBIA",
>     "description": "This condition is set for payments made only in Colombia"
>   }
> }
> ```

## v2024-03

*31 de marzo de 2024*

**Payments**

* ADDED **Campo de fecha de creación del cliente en el comercio**\
  Un nuevo campo `merchant_customer_created_at` (formato ISO 8601) está disponible en los objetos Customer y `customer_payer`, y representa la fecha en que el cliente se registró en la plataforma del comercio.
  *Ver también: [Referencia del objeto de cliente](https://docs.y.uno/es/reference/customers/the-customer-object.md)*

* ADDED **Plan de cuotas en la sesión de checkout**\
  Un nuevo arreglo `installments.plan` y un nuevo campo `installments.plan_id` están disponibles en el objeto de sesión de checkout, que te permiten especificar un plan de cuotas personalizado por sesión. Si se omiten, se usa el plan a nivel de cuenta.
  *Ver también: [Referencia de creación de sesión de checkout](https://docs.y.uno/es/reference/checkout-sessions/create-checkout-session.md)*

* ADDED **URL de callback para enlaces de pago**\
  Un nuevo campo `callback_url` está disponible al crear un enlace de pago, y especifica la URL a la que se redirige al cliente después de completar el pago.
  *Ver también: [Referencia del objeto de enlace de pago](https://docs.y.uno/es/reference/payment-links/the-payment-link-object.md)*

## v2024-02

*29 de febrero de 2024*

* ADDED **Campo de barrio en los objetos de dirección**\
  Se agregó un nuevo campo `neighborhood` (de 3 a 255 caracteres) a `shipping_address` y `billing_address` en el objeto Customer.
  *Ver también: [Referencia del objeto de cliente](https://docs.y.uno/es/reference/customers/the-customer-object.md)*

**Payments**

* ADDED **Arreglo del historial de transacciones**\
  Ahora se devuelve un nuevo arreglo `transactions_history` en el objeto de pago, que enumera todas las transacciones asociadas con un pago, incluidas las de varias rutas de proveedores.
  *Ver también: [Referencia del objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md)*

* ADDED **Campo de propina en los datos de la orden**\
  Un nuevo campo `tip_amount` está disponible dentro de `additional_data.order`. Es solo informativo: la propina ya está incluida en el valor total de la transacción y no se suma por separado.
  *Ver también: [Guía de detalles del monto del pago](https://docs.y.uno/es/docs/payment-features/payment-amount-details.md)*

> [accordion] tip\_amount en additional\_data.order
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> "additional_data": {
>   "order": {
>     "tip_amount": 50.00
>   }
> }
> ```

* ADDED **Mensaje de error de captura en curso**\
  Ahora la API devuelve una respuesta de error específica cuando se intenta una captura mientras otra captura ya está en curso: `INVALID_STATUS` con el mensaje "Invalid transaction status. Transaction already in progress". No se requieren cambios en la integración.
  *Ver también: [Referencia del objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md)*

> [accordion] Respuesta de error INVALID\_STATUS
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> {
>   "code": "INVALID_STATUS",
>   "messages": [
>     "Invalid transaction status. Transaction already in progress"
>   ]
> }
> ```

## v2024-01

*31 de enero de 2024*

* ADDED **Campos de datos del proveedor en la transacción**\
  Ahora se devuelven tres campos nuevos dentro de `transactions.provider_data`: `response_code` (código de resultado del proveedor), `third_party_account_id` (ID de cuenta del procesador) y `third_party_transaction_id` (ID de transacción del procesador). No se requieren cambios en la integración.
  *Ver también: [Referencia del objeto de pago](https://docs.y.uno/es/reference/payments/the-payment-object.md)*

**Seguridad**

* ADDED **Compatibilidad con credenciales almacenadas**\
  Yuno ahora admite las reglas de credenciales almacenadas de Visa y Mastercard, lo que permite a los comercios marcar los pagos como transacciones iniciadas por el cliente (CIT) o transacciones iniciadas por el comercio (MIT) mediante la estructura `stored_credentials` dentro de `payment_method.detail.card`.
  *Ver también: [Guía de credenciales almacenadas](https://docs.y.uno/es/docs/payment-features/stored-credentials.md)*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.