> ## 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.

# Actualizar un enrutamiento

> Reemplaza la configuración completa de un enrutamiento existente, identificado por su routing_id.

Reemplaza la configuración completa del enrutamiento. El cuerpo tiene la misma estructura que [Crear un enrutamiento](https://docs.y.uno/es/reference/organizations/routing/create-routing.md): el nuevo `default_route` y los `condition_sets[]` reemplazan por completo el estado activo anterior. **No hay combinación a nivel de campo.**

`account_id` y `payment_method` están fijos para el `routing_id`: se definen al crearlo y `PATCH` no puede cambiarlos. Ambos siguen siendo obligatorios en el cuerpo y deben coincidir con el enrutamiento.

Esto también aplica a las divisiones por porcentaje: un conjunto de condiciones enviado sin `start_split` vuelve a una sola entrada en el paso 1, y una salida enviada sin `next_split` conserva solo el `next` que declara. Consulta primero el enrutamiento si quieres conservar las divisiones que ya tiene.

No todo lo que el cuerpo omite se elimina. Esto es lo que ocurre con cada parte que omite la solicitud:

| Omitido en la solicitud | Resultado |
| - | - |
| `retry` en una salida | Se conserva como estaba almacenado para esa posición. Envía `retry: false` para desactivar un reintento. |
| Un paso `CAPTURE` o `HOLD_FOR_REVIEW` almacenado, con la salida de la que colgaba enviada sin `next` | Se conserva y se vuelve a conectar. Omitirlo **no** elimina una captura automática; en su lugar, apunta esa salida a otro paso. |
| `action_delay` en un paso `CAPTURE` | Se conserva como estaba almacenado. Envía el paso con su nuevo `action_delay` para cambiarlo. |
| `fraud` en un paso de fraude | Se conserva como estaba almacenado. Si se envía, los seis campos se reemplazan. |
| `network_token_on` en un paso de pago | Se conserva como estaba almacenado. Envía `network_token_on: false` para desactivarlo. Enviar de vuelta el valor almacenado no se valida de nuevo; solo un valor modificado pasa por las validaciones de network token. |
| `three_d_secure_exemptions` en un paso 3DS | Se conserva como estaba almacenado. Envía `three_d_secure_exemptions: []` para borrarlo. |
| Un paso de smart routing almacenado | **Se elimina.** El paso de smart routing pertenece a la solicitud: un cuerpo que no lo incluye, por ejemplo uno consultado antes de que el smart routing fuera visible en esta API, lo elimina. Consulta primero el enrutamiento y envía el paso de vuelta. |
| Un paso `CANCEL` o `REVERT` | Se elimina, como cualquier otro paso que el cuerpo no incluya. |
| `start_split` / `next_split` | Se restablecen: un conjunto de condiciones enviado sin `start_split` vuelve a una sola entrada en el paso 1, y una salida enviada sin `next_split` conserva solo su `next`. |
| Partes que la API no devuelve (acciones `REFUND`, `DECLINE` y `END`, monitores) | Se conservan exactamente como estaban almacenadas, de modo que enviar de vuelta lo que te dio [Consultar un enrutamiento](https://docs.y.uno/es/reference/organizations/routing/retrieve-routing.md) mantiene el enrutamiento como estaba. Cambia esas partes en el dashboard. Consulta [Qué no muestra la API](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#what-the-api-does-not-show). |

### Parámetros de ruta

**routing\_id** `string` *required*

El id devuelto por [Crear un enrutamiento](https://docs.y.uno/es/reference/organizations/routing/create-routing.md).

### Cuerpo

**account\_id** `string (UUID)` *required*

La cuenta a la que pertenece el enrutamiento. Debe coincidir con la cuenta del enrutamiento.

**payment\_method** `enum` *required*

Debe coincidir con el `payment_method` del enrutamiento.

**name** `string` *required*

Etiqueta de formato libre.

**default\_route** `object` *required*

La ruta que se usa cuando ningún `condition_sets[]` coincide.

**propiedades**

**start\_split** `object[]`

Opcional. Divide la entrada de la ruta entre varios pasos por porcentaje, como `[{ "index": 1, "percentage": 45 }, { "index": 2, "percentage": 55 }]`. Los porcentajes son enteros que deben sumar `100`. Omítelo para iniciar cada pago en el paso 1. Consulta [Divisiones por porcentaje](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#percentage-splits).

**steps** `object[]` *required*

Cada paso es un intento con un proveedor o un [paso de acción](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#action-steps). Los valores de `index` son contiguos y empiezan en 1.

**elemento**

**index** `integer` *required*

Número de orden del paso.

**provider\_id** `string`

Obligatorio en los pasos de proveedor (un proveedor de pago, fraude, 3DS o autenticación) y `SMART_ROUTING` en un paso de smart routing; omítelo en un paso de acción. Debe coincidir con el proveedor de la conexión.

**connection\_id** `UUID`

Obligatorio en los pasos de proveedor; omítelo en los pasos de acción y de smart routing. Debe estar `ACTIVE` y ser compatible con el `payment_method`.

**fraud** `object`

Configuración de un paso de proveedor de fraude: `rules`, `blocklists`, `allowlists`, `reviewlists`, `preset` (códigos copiados del dashboard, que se conservan tal como se dan) y `report_only`. Solo en proveedores `FRAUD`. Consulta [Tipos de paso de proveedor](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#provider-step-kinds).

**network\_token\_on** `boolean`

Solo en los pasos de proveedor de pago de un enrutamiento `CARD`. `true` paga con el network token de la tarjeta cuando hay uno disponible. La organización debe estar inscrita en network tokens y el proveedor debe admitirlos (`network_token_enable` en la respuesta); de lo contrario, `400 NETWORK_TOKEN_NOT_ONBOARDED` o `400 NETWORK_TOKEN_NOT_SUPPORTED`. Si se omite, se conserva el valor almacenado; envía `false` para desactivarlo. Consulta [Configuración del paso de proveedor](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#provider-step-settings).

**three\_d\_secure\_exemptions** `string[]`

Solo en los pasos de proveedor 3DS. Las [exenciones SCA](https://docs.y.uno/es/docs/payment-features/sca-exemptions.md#allowed-values) que este paso puede aplicar, p. ej. `["LOW_VALUE", "TRANSACTION_RISK_ANALYSIS"]`. Si se omite, se conserva la lista almacenada; envía `[]` para borrarla. Consulta [Configuración del paso de proveedor](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#provider-step-settings).

**smart\_routing** `object`

Convierte el paso en un paso de smart routing: `type` (`COSTS` o `LATENCY`), `providers` (de dos a cuatro proveedores de pago `{ provider_id, connection_id, network_token_on }`) y `no_retry_decline_types`. Solo enrutamientos de tarjeta, uno por ruta. Consulta [Pasos de smart routing](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#smart-routing-steps).

**action** `enum`

Convierte el paso en un paso de acción: `CANCEL` rechaza el pago, `CAPTURE` captura la autorización, `HOLD_FOR_REVIEW` lo deja pendiente de revisión manual, `REVERT` lo revierte tras una evaluación de fraude que se ejecutó después del pago. `CAPTURE` y `HOLD_FOR_REVIEW` solo se alcanzan desde salidas `APPROVED` o `SUCCEEDED_GROUP` de un paso de pago o de smart routing, `REVERT` solo desde las salidas de un paso de fraude que se ejecuta después del pago, y `CANCEL` nunca desde una aprobación. Un paso de acción no tiene `provider_id`, `connection_id` ni `output`. Consulta [Pasos de acción](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#action-steps).

**action\_delay** `string`

Solo con `action = CAPTURE`. Duración ISO-8601 entre la aprobación y la captura, de al menos `PT1M` y como máximo `P7D` (p. ej. `PT5M`, `PT3H`, `P2D`). Si se omite, se conserva el retraso almacenado; un paso nuevo sin él captura en cuanto se procesa la aprobación.

**output** `object[]`

Define cómo manejar cada resultado posible de este paso. No se permite en un paso de acción.

**elemento**

**status** `string` *required*

El estado del resultado que activa esta regla: `APPROVED`, `DECLINED`, `DECLINE_GROUP`, `MAC_CODE_GROUP`, `SUCCEEDED_GROUP`, `PENDING` (solo en pasos de fraude, 3DS y autenticación) o `INTERNAL_ERROR`.

**group\_id** `integer`

Id de un grupo de la cuenta, de [Listar grupos de rechazo](https://docs.y.uno/es/reference/organizations/routing/list-decline-groups.md) o [Listar grupos de éxito](https://docs.y.uno/es/reference/organizations/routing/list-succeeded-groups.md). Obligatorio cuando `status` es `MAC_CODE_GROUP` o `SUCCEEDED_GROUP`; opcional en `DECLINE_GROUP`; no se permite en los demás casos. `MAC_CODE_GROUP` acepta un grupo de Merchant Advice Code; `DECLINE_GROUP` acepta un grupo de rechazo o un grupo de Merchant Advice Code (consulta [Grupos de resultado](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#outcome-groups)).

**decline\_types** `string[]`

Subestados de rechazo (p. ej., `INSUFFICIENT_FUNDS`, `DECLINED_BY_BANK`). En `DECLINE_GROUP`, es obligatorio a menos que se envíe `group_id`; con `group_id`, debe ser igual a los miembros del grupo. No se permite en `SUCCEEDED_GROUP`.

**retry** `boolean`

`true` intenta una vez más con el mismo proveedor cuando ocurre este resultado, antes de seguir `next`. Solo en `DECLINED`, `INTERNAL_ERROR` y `DECLINE_GROUP`. Si se omite, se conserva el valor almacenado. Consulta [Reintento](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#retry) para las entradas `DECLINE_GROUP` en un grupo de Merchant Advice Code.

**next** `integer`

El `index` del siguiente paso que se ejecutará. Omítelo si no se necesita una alternativa. Opcional junto a `next_split`; si se envían ambos, debe ser la primera entrada de `next_split`.

**next\_split** `object[]`

Divide la alternativa entre varios pasos por porcentaje, como `[{ "index": 2, "percentage": 70 }, { "index": 3, "percentage": 30 }]`. Al menos dos entradas, porcentajes enteros que sumen `100`. Con esto, `next` no es obligatorio.

**condition\_sets** `object[]`

Opcional. Ordenados por `sort_number`: gana el primer conjunto que coincida.

**elemento**

**sort\_number** `integer` *required*

Prioridad del conjunto de condiciones.

**name** `string` *required*

Etiqueta del conjunto.

**conditions** `object[]` *required*

Lista de [condiciones](https://docs.y.uno/es/reference/organizations/routing/routing-conditions.md) que deben coincidir. Además de `condition_type`, `conditional`, `values`, `key` y `currency`, una condición `TIME_PERIOD` incluye sus campos de horario, una condición `VOLUME_PAYMENTS_LIMIT` sus campos `limit_by`, `payments_count` y de periodo, y una condición `ORDER_ITEMS_AMOUNT` sus `item_values`.

**route** `object` *required*

Los pasos que se ejecutan si este conjunto coincide. Misma estructura que `default_route`, incluidos `start_split`, `output[].next_split` y los pasos de acción.

### Respuesta

**id** `string`

Identificador único del enrutamiento.

**account\_id** `string`

Identificador único de la cuenta.

**payment\_method** `enum`

El método de pago al que se aplica este enrutamiento (p. ej., `CARD`).

**name** `string`

Etiqueta del enrutamiento.

**default\_route** `object`

La lógica de enrutamiento predeterminada, con la estructura descrita en [Consultar un enrutamiento](https://docs.y.uno/es/reference/organizations/routing/retrieve-routing.md).

**condition\_sets** `object[]`

Lógica condicional opcional.

**created\_at** `string`

Marca de tiempo ISO 8601.

**updated\_at** `string`

Marca de tiempo ISO 8601.

```bash cURL theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
curl -X PATCH 'https://api.y.uno/v1/routing/8f2c1d3e-4b5a-4c7d-8e9f-0a1b2c3d4e5f' \
  -H 'public-api-key: <YOUR_PUBLIC_KEY>' \
  -H 'private-secret-key: <YOUR_SECRET_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'X-Idempotency-Key: <UUID>' \
  -d '{
    "account_id": "7825fc5e-e50a-4248-9ae8-5d3786afb0be",
    "payment_method": "CARD",
    "name": "Card routing v2 — business-hours rule and monthly limit",
    "default_route": {
      "steps": [
        {
          "index": 1,
          "provider_id": "STRIPE",
          "connection_id": "f1a3c4d5-7b8e-4a2c-9d1e-3f4a5b6c7d8e",
          "output": [
            { "status": "DECLINED",       "next": 2, "retry": false },
            { "status": "INTERNAL_ERROR", "next": 2, "retry": false }
          ]
        },
        {
          "index": 2,
          "provider_id": "ADYEN",
          "connection_id": "b2c4d5e6-1a2b-4c3d-8e4f-5a6b7c8d9e0f"
        }
      ]
    },
    "condition_sets": [
      {
        "sort_number": 1,
        "name": "First USD 50,000 of the month via dLocal",
        "conditions": [
          { "condition_type": "VOLUME_PAYMENTS_LIMIT", "conditional": "LESS_OR_EQUAL_THAN", "values": ["50000"],
            "currency": "USD", "limit_by": "VOLUME", "payments_count": "ALL",
            "time_period_repeat_amount": 1, "time_period_repeat_frequency": "MONTHLY", "timezone": "-03:00" }
        ],
        "route": {
          "steps": [
            { "index": 1, "provider_id": "DLOCAL", "connection_id": "c3d5e6f7-2b3c-4d5e-8f6a-7b8c9d0e1f2a" }
          ]
        }
      },
      {
        "sort_number": 2,
        "name": "Business hours via Adyen",
        "conditions": [
          { "condition_type": "TIME_PERIOD", "conditional": "EQUAL", "values": ["2026-10-01T00:00:00-03:00"],
            "time_period_repeat_amount": 1, "time_period_repeat_frequency": "WEEKLY",
            "time_period_repetition_days": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY"],
            "time_period_start_time": "09:00:00", "time_period_end_time": "18:00:00", "timezone": "-03:00" }
        ],
        "route": {
          "steps": [
            { "index": 1, "provider_id": "ADYEN", "connection_id": "b2c4d5e6-1a2b-4c3d-8e4f-5a6b7c8d9e0f" }
          ]
        }
      }
    ]
  }'
```

```json 200 OK — Updated theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "id": "8f2c1d3e-4b5a-4c7d-8e9f-0a1b2c3d4e5f",
  "account_id": "7825fc5e-e50a-4248-9ae8-5d3786afb0be",
  "payment_method": "CARD",
  "name": "Card routing v2 — business-hours rule and monthly limit",
  "default_route": {
    "steps": [
      {
        "index": 1,
        "provider_id": "STRIPE",
        "connection_id": "f1a3c4d5-7b8e-4a2c-9d1e-3f4a5b6c7d8e",
        "output": [
          { "status": "DECLINED",       "next": 2, "retry": false },
          { "status": "INTERNAL_ERROR", "next": 2, "retry": false }
        ]
      },
      { "index": 2, "provider_id": "ADYEN", "connection_id": "b2c4d5e6-1a2b-4c3d-8e4f-5a6b7c8d9e0f", "output": [{ "status": "APPROVED", "next": null, "decline_types": null, "retry": false }, { "status": "INTERNAL_ERROR", "next": null, "decline_types": null, "retry": false }] }
    ]
  },
  "condition_sets": [
    {
      "sort_number": 1,
      "name": "First USD 50,000 of the month via dLocal",
      "conditions": [
        { "condition_type": "VOLUME_PAYMENTS_LIMIT", "conditional": "LESS_OR_EQUAL_THAN", "values": ["50000"],
          "currency": "USD", "limit_by": "VOLUME", "payments_count": "ALL",
          "time_period_repeat_amount": 1, "time_period_repeat_frequency": "MONTHLY", "timezone": "-03:00" }
      ],
      "route": { "steps": [ { "index": 1, "provider_id": "DLOCAL", "connection_id": "c3d5e6f7-2b3c-4d5e-8f6a-7b8c9d0e1f2a", "output": [{ "status": "APPROVED", "next": null, "decline_types": null, "retry": false }, { "status": "INTERNAL_ERROR", "next": null, "decline_types": null, "retry": false }] } ] }
    },
    {
      "sort_number": 2,
      "name": "Business hours via Adyen",
      "conditions": [
        { "condition_type": "TIME_PERIOD", "conditional": "EQUAL", "values": ["2026-10-01T00:00:00-03:00"],
          "time_period_repeat_amount": 1, "time_period_repeat_frequency": "WEEKLY",
          "time_period_repetition_days": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY"],
          "time_period_start_time": "09:00:00", "time_period_end_time": "18:00:00", "timezone": "-03:00" }
      ],
      "route": { "steps": [ { "index": 1, "provider_id": "ADYEN", "connection_id": "b2c4d5e6-1a2b-4c3d-8e4f-5a6b7c8d9e0f", "output": [{ "status": "APPROVED", "next": null, "decline_types": null, "retry": false }, { "status": "INTERNAL_ERROR", "next": null, "decline_types": null, "retry": false }] } ] }
    }
  ],
  "created_at": "2026-05-12T14:30:00Z",
  "updated_at": "2026-05-13T09:18:42Z"
}
```

```json 400 — Immutable Payment Method theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "code": "ROUTING_PAYMENT_METHOD_IMMUTABLE",
  "messages": ["payment_method cannot be changed once the routing is created. Stored payment_method='CARD', requested='PIX'."]
}
```

```json 400 — Group of the wrong kind theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "code": "INVALID_ROUTE_CONFIGURATION",
  "messages": ["output.group_id=1044 is a DECLINE_GROUP group and cannot be used with status MAC_CODE_GROUP"]
}
```

### Errores

| HTTP | `code` |
| - | - |
| `404` | `ROUTING_NOT_FOUND` `routing_id` desconocido, o el id pertenece a otra cuenta. |
| `400` | `INVALID_PARAMETERS` Falta un campo o tiene un valor no válido: un paso sin `provider_id` ni `action`, un `status` o `action` fuera de sus enums, un `action_delay` en un paso que no es `CAPTURE`, un `group_id` con formato incorrecto. `messages` indica el campo que causa el error. |
| `400` | `INVALID_FORMAT` Un campo tiene un tipo o formato incorrecto: `time_period_start_time` / `time_period_end_time` que no están en formato `HH:mm:ss`, una fecha en `values` de una condición `TIME_PERIOD` que no es ISO-8601, `time_period_repeat_amount` o `sort_number` que no son enteros, `retry` que no es booleano. `messages` indica el campo. |
| `400` | `INVALID_ROUTE_CONFIGURATION` Violación de una regla de la ruta: índices de paso no contiguos, un `next` o una rama de división hacia un paso inexistente, una división que no suma 100 o deja un paso inalcanzable, un paso `CAPTURE` o `HOLD_FOR_REVIEW` que no se alcanza solo desde `APPROVED`, un `action_delay` menor de 1 minuto o mayor de 7 días, `retry` en un estado que no lo admite o en un grupo de Merchant Advice Code que el enrutamiento almacenado aún no reintenta (consulta [Reintento](https://docs.y.uno/es/reference/organizations/routing/routing-resource-shape.md#retry)), un `group_id` desconocido, de otra cuenta o del tipo incorrecto, `decline_types` que no coinciden con el grupo, una condición que infringe una regla de su `condition_type`, o un `connection_id` que no se encuentra para la cuenta y el proveedor. `messages` explica qué regla se infringió. |
| `400` | `INVALID_VOLUME_LIMIT_CURRENCY`, `INVALID_VOLUME_LIMIT_PERIOD`, `UNSUPPORTED_VOLUME_LIMIT_TIMEZONE` Una condición `VOLUME_PAYMENTS_LIMIT` con una moneda, un periodo o una zona horaria no válidos. Consulta [Límites de volumen y de cantidad](https://docs.y.uno/es/reference/organizations/routing/routing-conditions.md#volume-and-count-limits-volume_payments_limit). |
| `400` | `INVALID_PROVIDER_ID` `provider_id` tiene un formato no válido. |
| `400` | `ROUTING_PAYMENT_METHOD_IMMUTABLE` El `payment_method` del cuerpo no coincide con el `payment_method` del enrutamiento. |
| `409` | `ROUTING_VERSION_CONFLICT` Otro `PATCH` concurrente ganó la carrera de publicación. |
| `401` | `NOT_AUTHENTICATED` Falta el encabezado `public-api-key` o `private-secret-key`. |
| `401` | `INVALID_CREDENTIALS` Par de claves incorrecto, o se usó una **Customized API key** del Dashboard. Usa en su lugar una clave de cuenta o de organización. |


## OpenAPI

````yaml openapi/es/organizations/routing/update-routing.json PATCH /routing/{routing_id}
openapi: 3.1.0
info:
  title: Routing API - Update
  version: 1.0.0
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /routing/{routing_id}:
    patch:
      summary: Actualizar un enrutamiento
      description: Reemplaza la configuración completa del enrutamiento.
      operationId: update-routing
      parameters:
        - name: routing_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: X-Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - account_id
                - payment_method
                - name
                - default_route
              properties:
                account_id:
                  type: string
                  format: uuid
                  example: 7825fc5e-e50a-4248-9ae8-5d3786afb0be
                  description: Debe coincidir con la cuenta del enrutamiento.
                payment_method:
                  type: string
                  example: CARD
                  description: Debe coincidir con el payment_method del enrutamiento.
                name:
                  type: string
                  example: Card routing
                default_route:
                  type: object
                  required:
                    - steps
                  properties:
                    start_split:
                      type: array
                      description: >-
                        Divide la entrada de la ruta entre varios pasos según
                        porcentajes. Omítelo para iniciar todos los pagos en el
                        paso 1. Las entradas deben sumar 100; se devuelve solo
                        cuando la ruta tiene una entrada dividida.
                      items:
                        type: object
                        required:
                          - index
                          - percentage
                        properties:
                          index:
                            type: integer
                            example: 1
                          percentage:
                            type: integer
                            example: 45
                    steps:
                      type: array
                      items:
                        type: object
                        required:
                          - index
                        properties:
                          index:
                            type: integer
                            example: 1
                          provider_id:
                            type: string
                            example: STRIPE
                            description: >-
                              Obligatorio en los pasos de proveedor
                              (SMART_ROUTING en un paso de enrutamiento
                              inteligente); ausente en los pasos de acción. Debe
                              coincidir con el proveedor de la conexión.
                          connection_id:
                            type: string
                            format: uuid
                            example: f1a3c4d5-7b8e-4a2c-9d1e-3f4a5b6c7d8e
                            description: >-
                              Obligatorio en los pasos de proveedor; ausente en
                              los pasos de acción y de enrutamiento inteligente.
                              Debe estar ACTIVE y admitir el payment_method.
                          action:
                            type: string
                            enum:
                              - CANCEL
                              - CAPTURE
                              - HOLD_FOR_REVIEW
                              - REVERT
                            description: >-
                              Convierte el paso en un paso de acción que termina
                              la ruta: CANCEL rechaza el pago, CAPTURE captura
                              la autorización después de action_delay,
                              HOLD_FOR_REVIEW lo deja pendiente de revisión
                              manual, REVERT lo revierte después de una
                              evaluación de fraude posterior al pago. CAPTURE y
                              HOLD_FOR_REVIEW siguen a una salida APPROVED o
                              SUCCEEDED_GROUP de un paso de pago o de
                              enrutamiento inteligente, REVERT sigue a las
                              salidas de un paso de fraude que se ejecuta
                              después del pago, CANCEL nunca sigue a una
                              aprobación. Un paso de acción no tiene
                              provider_id, connection_id ni output.
                          action_delay:
                            type: string
                            example: PT5M
                            description: >-
                              Solo con action = CAPTURE. Duración ISO-8601 entre
                              la aprobación y la captura, de al menos PT1M y
                              como máximo P7D. Omítelo para capturar en cuanto
                              se procese la aprobación.
                          output:
                            type: array
                            items:
                              type: object
                              required:
                                - status
                              properties:
                                status:
                                  type: string
                                  example: DECLINED
                                  description: >-
                                    APPROVED, DECLINED, DECLINE_GROUP,
                                    MAC_CODE_GROUP, SUCCEEDED_GROUP, PENDING
                                    (solo en pasos de fraude, 3DS y
                                    autenticación) o INTERNAL_ERROR.
                                decline_types:
                                  type: array
                                  items:
                                    type: string
                                  description: >-
                                    Subestados de rechazo. En DECLINE_GROUP, es
                                    obligatorio a menos que se envíe group_id;
                                    con group_id debe ser igual a los miembros
                                    del grupo. No se permite en SUCCEEDED_GROUP.
                                group_id:
                                  type: integer
                                  example: 1044
                                  description: >-
                                    Id de un grupo de rechazo, de Merchant
                                    Advice Code o de éxito de la cuenta
                                    (consulta Listar grupos de rechazo y Listar
                                    grupos de éxito). Obligatorio en
                                    MAC_CODE_GROUP y SUCCEEDED_GROUP, opcional
                                    en DECLINE_GROUP, no permitido en los demás
                                    casos. MAC_CODE_GROUP recibe un grupo de
                                    Merchant Advice Code; DECLINE_GROUP recibe
                                    un grupo de rechazo o un grupo de Merchant
                                    Advice Code.
                                retry:
                                  type: boolean
                                  example: false
                                  description: >-
                                    true intenta una vez más con el mismo
                                    proveedor cuando ocurre este resultado,
                                    antes de seguir con next. Solo en DECLINED,
                                    INTERNAL_ERROR y DECLINE_GROUP; en una
                                    entrada DECLINE_GROUP que referencia un
                                    grupo de Merchant Advice Code, solo cuando
                                    el enrutamiento guardado ya reintenta ese
                                    grupo en el mismo paso, por lo que siempre
                                    se rechaza al crear. Al actualizar, si se
                                    omite retry se conserva el valor guardado.
                                next:
                                  type: integer
                                  example: 2
                                next_split:
                                  type: array
                                  description: >-
                                    Divide el respaldo (fallback) entre varios
                                    pasos según porcentajes: al menos 2 entradas
                                    cuyos porcentajes sumen 100. next es
                                    opcional junto a este campo y, si se envía,
                                    debe ser igual a la primera entrada; las
                                    respuestas devuelven next = primera entrada
                                    junto con next_split.
                                  items:
                                    type: object
                                    required:
                                      - index
                                      - percentage
                                    properties:
                                      index:
                                        type: integer
                                        example: 2
                                      percentage:
                                        type: integer
                                        example: 70
                            description: >-
                              Manejadores por resultado de un paso de proveedor.
                              No se permite en un paso de acción.
                          network_token_on:
                            type: boolean
                            description: >-
                              Solo en pasos de proveedor de pago de un
                              enrutamiento CARD. true paga con el token de red
                              de la tarjeta cuando hay uno disponible; requiere
                              que la organización esté habilitada para tokens de
                              red y un proveedor que los admita
                              (network_token_enable en la respuesta); de lo
                              contrario, 400 NETWORK_TOKEN_NOT_ONBOARDED o
                              NETWORK_TOKEN_NOT_SUPPORTED. Si se omite al
                              actualizar, se conserva el valor almacenado; false
                              lo desactiva.
                          three_d_secure_exemptions:
                            type: array
                            items:
                              type: string
                              enum:
                                - LOW_VALUE
                                - TRANSACTION_RISK_ANALYSIS
                                - SECURE_CORPORATE
                                - TRUSTED_BENEFICIARY
                                - RECURRING_PAYMENT
                                - STRONG_CUSTOMER_AUTHENTICATION
                                - OUT_OF_SCOPE
                            description: >-
                              Solo en pasos de proveedor 3DS. Las exenciones de
                              SCA que este paso puede aplicar. Si se omite al
                              actualizar, se conserva la lista almacenada; [] la
                              borra.
                          fraud:
                            type: object
                            description: >-
                              Configuración de un paso de proveedor de fraude.
                              Solo en proveedores FRAUD; si se omite al
                              actualizar, se conserva la configuración
                              almacenada.
                            properties:
                              rules:
                                type: string
                                example: rule-a,rule-b
                              blocklists:
                                type: string
                              allowlists:
                                type: string
                              reviewlists:
                                type: string
                              preset:
                                type: string
                              report_only:
                                type: boolean
                                description: >-
                                  Evalúa el puntaje sin actuar sobre el
                                  resultado. Solo en un paso de fraude al que se
                                  llega desde salidas rechazadas de un paso de
                                  pago.
                          smart_routing:
                            type: object
                            description: >-
                              Convierte el paso en un paso de enrutamiento
                              inteligente (provider_id SMART_ROUTING, sin
                              connection_id). Solo enrutamientos de tarjeta, uno
                              por ruta.
                            required:
                              - type
                              - providers
                            properties:
                              type:
                                type: string
                                enum:
                                  - COSTS
                                  - LATENCY
                                example: LATENCY
                              providers:
                                type: array
                                minItems: 2
                                maxItems: 4
                                items:
                                  type: object
                                  required:
                                    - provider_id
                                    - connection_id
                                  properties:
                                    provider_id:
                                      type: string
                                      example: ADYEN
                                    connection_id:
                                      type: string
                                      format: uuid
                                    network_token_on:
                                      type: boolean
                              no_retry_decline_types:
                                type: array
                                items:
                                  type: string
                                description: >-
                                  Subestados de rechazo después de los cuales no
                                  se prueba el siguiente proveedor del conjunto.
                              no_retry_failure_causes:
                                type: array
                                items:
                                  type: string
                                description: >-
                                  Causas de falla (por ejemplo,
                                  PROVIDER_TIMEOUT) después de las cuales no se
                                  prueba el siguiente proveedor del conjunto.
                        description: >-
                          Un intento de proveedor (provider_id + connection_id)
                          o un paso de acción (action). Los valores de index son
                          contiguos y comienzan en 1.
                condition_sets:
                  type: array
                  description: >-
                    Opcional. Ordenado por sort_number; gana el primer conjunto
                    que coincida.
                  items:
                    type: object
                    required:
                      - sort_number
                      - name
                      - conditions
                      - route
                    properties:
                      sort_number:
                        type: integer
                        example: 1
                      name:
                        type: string
                        example: US & Canada — high value
                      description:
                        type: string
                      conditions:
                        type: array
                        items:
                          type: object
                          required:
                            - condition_type
                            - conditional
                            - values
                          properties:
                            condition_type:
                              type: string
                              example: COUNTRY
                              description: >-
                                Consulta Condiciones de enrutamiento para ver el
                                catálogo: COUNTRY, CARD_ISSUER_COUNTRY, AMOUNT,
                                CURRENCY, CARD_TYPE, CARD_BRAND, CARD_BIN,
                                TRANSACTION_TYPE, METADATA, ADDITIONAL_FIELD,
                                ORDER_ITEMS_AMOUNT, TIME_PERIOD,
                                VOLUME_PAYMENTS_LIMIT, SUBSCRIPTION_RETRY,
                                SUBSCRIPTION_RETRY_COUNT.
                            conditional:
                              type: string
                              example: ONE_OF
                            values:
                              type: array
                              items:
                                type: string
                              example:
                                - US
                                - CA
                              description: >-
                                En CURRENCY, códigos ISO 4217 en mayúsculas (no
                                XXX, sin repetidos): exactamente 1 con EQUAL o
                                NOT_EQUAL, 1 o más con ONE_OF o NOT_ONE_OF.
                                Vacío solo en una condición AMOUNT con currency,
                                que entonces coincide con cualquier monto en esa
                                moneda. En ORDER_ITEMS_AMOUNT, el umbral
                                numérico para la suma de los ítems: 1 valor, 2
                                con BETWEEN.
                            key:
                              type: string
                              description: >-
                                METADATA: la clave de metadata.
                                ADDITIONAL_FIELD: el nombre del campo
                                compatible. ORDER_ITEMS_AMOUNT: el campo del
                                ítem de la orden contra el que se compara
                                item_values, sku_code (por defecto), category o
                                brand.
                            item_values:
                              type: array
                              items:
                                type: string
                              example:
                                - GC-50
                                - GC-100
                                - GC-200
                              description: >-
                                Solo para ORDER_ITEMS_AMOUNT, y obligatorio en
                                ella: lista no vacía de valores de ítems de la
                                orden (exactos, sensibles a mayúsculas) cuya
                                cantidad × unit_amount se suma. Se rechaza en
                                cualquier otro condition_type.
                            currency:
                              type: string
                              example: USD
                              description: >-
                                ISO 4217. Obligatorio en AMOUNT, en
                                ORDER_ITEMS_AMOUNT y en VOLUME_PAYMENTS_LIMIT
                                con limit_by = VOLUME. No se envía en CURRENCY,
                                cuyas monedas van en values.
                            time_period_repeat_amount:
                              type: integer
                              example: 1
                              description: >-
                                TIME_PERIOD y VOLUME_PAYMENTS_LIMIT: cada
                                cuántas unidades de tiempo de
                                time_period_repeat_frequency (programación), o
                                la duración de una ventana DAILY en días, de 1 a
                                90 (limit).
                            time_period_repeat_frequency:
                              type: string
                              enum:
                                - DAILY
                                - WEEKLY
                                - MONTHLY
                                - QUARTERLY
                                - YEARLY
                              description: >-
                                TIME_PERIOD: unidad de recurrencia.
                                VOLUME_PAYMENTS_LIMIT: período del límite,
                                DAILY, MONTHLY o QUARTERLY.
                            time_period_repetition_days:
                              type: array
                              items:
                                type: string
                                enum:
                                  - MONDAY
                                  - TUESDAY
                                  - WEDNESDAY
                                  - THURSDAY
                                  - FRIDAY
                                  - SATURDAY
                                  - SUNDAY
                              description: >-
                                Solo TIME_PERIOD. Días de la semana a los que se
                                aplica la programación; requiere una frecuencia.
                            time_period_start_time:
                              type: string
                              example: '09:00:00'
                              description: >-
                                Solo TIME_PERIOD. Inicio de la ventana horaria
                                diaria (HH:mm:ss), junto con
                                time_period_end_time.
                            time_period_end_time:
                              type: string
                              example: '18:00:00'
                              description: >-
                                Solo TIME_PERIOD. Fin de la ventana horaria
                                diaria (HH:mm:ss), inclusive.
                            timezone:
                              type: string
                              example: '-03:00'
                              description: >-
                                Desfase UTC. TIME_PERIOD: desfase con el que se
                                lee la programación (por defecto, el desfase de
                                values[0]). VOLUME_PAYMENTS_LIMIT: desfase en
                                horas completas donde comienzan los períodos
                                (por defecto, +00:00).
                            limit_by:
                              type: string
                              enum:
                                - PAYMENTS
                                - VOLUME
                              description: >-
                                Solo VOLUME_PAYMENTS_LIMIT. Cuenta pagos
                                (predeterminado) o suma montos en la moneda.
                            payments_count:
                              type: string
                              enum:
                                - ALL
                                - SUCCEEDED
                              description: >-
                                Solo VOLUME_PAYMENTS_LIMIT. Qué pagos cuentan
                                para el límite. El valor predeterminado es ALL.
                        description: >-
                          Condiciones combinadas con AND lógico. Consulta
                          Routing Conditions.
                      route:
                        type: object
                        description: >-
                          Misma estructura que default_route, incluidos
                          start_split, output[].next_split y los pasos de
                          acción.
            example:
              account_id: 7825fc5e-e50a-4248-9ae8-5d3786afb0be
              payment_method: GOOGLE_PAY
              name: Google Pay routing v2
              default_route:
                steps:
                  - index: 1
                    provider_id: ADYEN
                    connection_id: b2c4d5e6-1a2b-4c3d-8e4f-5a6b7c8d9e0f
                    output:
                      - status: APPROVED
                        next: 3
                      - status: DECLINED
                        retry: false
                        next_split:
                          - index: 2
                            percentage: 70
                          - index: 4
                            percentage: 30
                  - index: 2
                    provider_id: ADYEN
                    connection_id: b2c4d5e6-1a2b-4c3d-8e4f-5a6b7c8d9e0f
                    output:
                      - status: APPROVED
                        next: 3
                  - index: 3
                    action: CAPTURE
                    action_delay: PT5M
                  - index: 4
                    action: CANCEL
              condition_sets:
                - sort_number: 1
                  name: US & Canada
                  conditions:
                    - condition_type: COUNTRY
                      conditional: ONE_OF
                      values:
                        - US
                        - CA
                  route:
                    steps:
                      - index: 1
                        action: CANCEL
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: 8f2c1d3e-4b5a-4c7d-8e9f-0a1b2c3d4e5f
                  account_id:
                    type: string
                    example: acc-uuid
                  payment_method:
                    type: string
                    example: CARD
                  name:
                    type: string
                    example: Updated Card routing v2
                  default_route:
                    type: object
                    properties:
                      start_split:
                        type: array
                        description: >-
                          Divide la entrada de la ruta entre varios pasos según
                          porcentajes. Omítelo para iniciar todos los pagos en
                          el paso 1. Las entradas deben sumar 100; se devuelve
                          solo cuando la ruta tiene una entrada dividida.
                        items:
                          type: object
                          required:
                            - index
                            - percentage
                          properties:
                            index:
                              type: integer
                              example: 1
                            percentage:
                              type: integer
                              example: 45
                      steps:
                        type: array
                        items:
                          type: object
                          properties:
                            index:
                              type: integer
                              example: 1
                            provider_id:
                              type: string
                              example: STRIPE
                              description: >-
                                Obligatorio en los pasos de proveedor; ausente
                                en los pasos de acción. Debe coincidir con el
                                proveedor de la conexión.
                            connection_id:
                              type: string
                              example: f1a3c4d5-7b8e-4a2c-9d1e-3f4a5b6c7d8e
                              description: >-
                                Obligatorio en los pasos de proveedor; ausente
                                en los pasos de acción y de enrutamiento
                                inteligente. Debe estar ACTIVE y admitir el
                                payment_method.
                            provider_type:
                              type: string
                              enum:
                                - PAYMENT
                                - FRAUD
                                - THREE_D_SECURE
                                - AUTHENTICATION
                              description: >-
                                El tipo al que se resuelve el proveedor. Solo en
                                la respuesta.
                            timeout:
                              type: integer
                              example: 60
                              description: >-
                                Pasos de proveedor. Tiempo de espera del
                                proveedor en segundos, tomado del catálogo de
                                proveedores. Solo en la respuesta.
                            network_token_enable:
                              type: boolean
                              description: >-
                                Pasos de pago. Indica si network_token_on puede
                                ser true en este paso: la organización está
                                habilitada para tokens de red y el proveedor los
                                admite. Solo en la respuesta.
                            network_token_on:
                              type: boolean
                              description: >-
                                Pasos de pago. Indica si el paso paga con el
                                token de red de la tarjeta cuando hay uno
                                disponible.
                            three_d_secure_exemptions:
                              type: array
                              items:
                                type: string
                                enum:
                                  - LOW_VALUE
                                  - TRANSACTION_RISK_ANALYSIS
                                  - SECURE_CORPORATE
                                  - TRUSTED_BENEFICIARY
                                  - RECURRING_PAYMENT
                                  - STRONG_CUSTOMER_AUTHENTICATION
                                  - OUT_OF_SCOPE
                              description: >-
                                Pasos 3DS. Las exenciones de SCA que el paso
                                puede aplicar; un arreglo vacío cuando no hay
                                ninguna.
                            action:
                              type: string
                              enum:
                                - CANCEL
                                - CAPTURE
                                - HOLD_FOR_REVIEW
                                - REVERT
                              description: >-
                                Convierte el paso en un paso de acción que
                                termina la ruta: CANCEL rechaza el pago, CAPTURE
                                captura la autorización después de action_delay,
                                HOLD_FOR_REVIEW lo deja pendiente de revisión
                                manual, REVERT lo revierte después de una
                                evaluación de fraude posterior al pago. CAPTURE
                                y HOLD_FOR_REVIEW siguen a una salida APPROVED o
                                SUCCEEDED_GROUP de un paso de pago o de
                                enrutamiento inteligente, REVERT sigue a las
                                salidas de un paso de fraude que se ejecuta
                                después del pago, CANCEL nunca sigue a una
                                aprobación. Un paso de acción no tiene
                                provider_id, connection_id ni output.
                            action_delay:
                              type: string
                              example: PT5M
                              description: >-
                                Solo con action = CAPTURE. Duración ISO-8601
                                entre la aprobación y la captura, de al menos
                                PT1M y como máximo P7D. Omítelo para capturar en
                                cuanto se procese la aprobación.
                            output:
                              type: array
                              items:
                                type: object
                                required:
                                  - status
                                properties:
                                  status:
                                    type: string
                                    example: DECLINED
                                    description: >-
                                      APPROVED, DECLINED, DECLINE_GROUP,
                                      MAC_CODE_GROUP, SUCCEEDED_GROUP, PENDING
                                      (solo en pasos de fraude, 3DS y
                                      autenticación) o INTERNAL_ERROR.
                                  decline_types:
                                    type: array
                                    items:
                                      type: string
                                    description: >-
                                      Miembros del grupo en las salidas
                                      DECLINE_GROUP (subestados de rechazo) y
                                      MAC_CODE_GROUP (Merchant Advice Codes).
                                  group_id:
                                    type: integer
                                    example: 1044
                                    description: >-
                                      Id del grupo detrás de una salida
                                      DECLINE_GROUP, MAC_CODE_GROUP o
                                      SUCCEEDED_GROUP.
                                  group_name:
                                    type: string
                                    example: Soft declines
                                    description: >-
                                      Nombre del grupo detrás de group_id. Se
                                      ignora al escribir.
                                  retry:
                                    type: boolean
                                    example: false
                                    description: >-
                                      Indica si esta salida reintenta una vez
                                      con el mismo proveedor antes de seguir
                                      next. Siempre se devuelve.
                                  next:
                                    type: integer
                                    example: 2
                                  next_split:
                                    type: array
                                    description: >-
                                      Divide el respaldo (fallback) entre varios
                                      pasos según porcentajes: al menos 2
                                      entradas cuyos porcentajes sumen 100. Se
                                      devuelve junto con next = primera entrada.
                                    items:
                                      type: object
                                      required:
                                        - index
                                        - percentage
                                      properties:
                                        index:
                                          type: integer
                                          example: 2
                                        percentage:
                                          type: integer
                                          example: 70
                              description: >-
                                Manejadores por resultado. Se devuelve como un
                                arreglo vacío en los pasos de acción.
                            fraud:
                              type: object
                              description: >-
                                Configuración de un paso de proveedor de fraude,
                                devuelta en los pasos FRAUD.
                              properties:
                                rules:
                                  type: string
                                  example: rule-a,rule-b
                                blocklists:
                                  type: string
                                allowlists:
                                  type: string
                                reviewlists:
                                  type: string
                                preset:
                                  type: string
                                report_only:
                                  type: boolean
                                  description: >-
                                    Evalúa el puntaje sin actuar sobre el
                                    resultado. Solo en un paso de fraude al que
                                    se llega desde salidas rechazadas de un paso
                                    de pago.
                            smart_routing:
                              type: object
                              description: >-
                                Se devuelve en los pasos de enrutamiento
                                inteligente.
                              properties:
                                type:
                                  type: string
                                  enum:
                                    - COSTS
                                    - LATENCY
                                  example: LATENCY
                                providers:
                                  type: array
                                  minItems: 2
                                  maxItems: 4
                                  items:
                                    type: object
                                    required:
                                      - provider_id
                                      - connection_id
                                    properties:
                                      provider_id:
                                        type: string
                                        example: ADYEN
                                      connection_id:
                                        type: string
                                        format: uuid
                                      network_token_on:
                                        type: boolean
                                no_retry_decline_types:
                                  type: array
                                  items:
                                    type: string
                                  description: >-
                                    Subestados de rechazo después de los cuales
                                    no se prueba el siguiente proveedor del
                                    conjunto.
                                no_retry_failure_causes:
                                  type: array
                                  items:
                                    type: string
                                  description: >-
                                    Causas de falla (por ejemplo,
                                    PROVIDER_TIMEOUT) después de las cuales no
                                    se prueba el siguiente proveedor del
                                    conjunto.
                  condition_sets:
                    type: array
                    items:
                      type: object
                      properties:
                        sort_number:
                          type: integer
                          example: 1
                        name:
                          type: string
                          example: Updated Card routing
                        description:
                          type: string
                        conditions:
                          type: array
                          items:
                            type: object
                            properties:
                              condition_type:
                                type: string
                                example: COUNTRY
                                description: >-
                                  Consulta Condiciones de enrutamiento para ver
                                  el catálogo: COUNTRY, CARD_ISSUER_COUNTRY,
                                  AMOUNT, CURRENCY, CARD_TYPE, CARD_BRAND,
                                  CARD_BIN, TRANSACTION_TYPE, METADATA,
                                  ADDITIONAL_FIELD, ORDER_ITEMS_AMOUNT,
                                  TIME_PERIOD, VOLUME_PAYMENTS_LIMIT,
                                  SUBSCRIPTION_RETRY, SUBSCRIPTION_RETRY_COUNT.
                              conditional:
                                type: string
                                example: ONE_OF
                              values:
                                type: array
                                items:
                                  type: string
                                example:
                                  - US
                                  - CA
                                description: >-
                                  En CURRENCY, códigos ISO 4217 en mayúsculas
                                  (no XXX, sin repetidos): exactamente 1 con
                                  EQUAL o NOT_EQUAL, 1 o más con ONE_OF o
                                  NOT_ONE_OF. Vacío solo en una condición AMOUNT
                                  con currency, que entonces coincide con
                                  cualquier monto en esa moneda. En
                                  ORDER_ITEMS_AMOUNT, el umbral numérico para la
                                  suma de los ítems: 1 valor, 2 con BETWEEN.
                              key:
                                type: string
                                description: >-
                                  METADATA: la clave de metadata.
                                  ADDITIONAL_FIELD: el nombre del campo
                                  compatible. ORDER_ITEMS_AMOUNT: el campo del
                                  ítem de la orden contra el que se compara
                                  item_values, sku_code (por defecto), category
                                  o brand.
                              item_values:
                                type: array
                                items:
                                  type: string
                                example:
                                  - GC-50
                                  - GC-100
                                  - GC-200
                                description: >-
                                  Solo para ORDER_ITEMS_AMOUNT, y obligatorio en
                                  ella: lista no vacía de valores de ítems de la
                                  orden (exactos, sensibles a mayúsculas) cuya
                                  cantidad × unit_amount se suma. Se rechaza en
                                  cualquier otro condition_type.
                              currency:
                                type: string
                                example: USD
                                description: >-
                                  ISO 4217. Obligatorio en AMOUNT, en
                                  ORDER_ITEMS_AMOUNT y en VOLUME_PAYMENTS_LIMIT
                                  con limit_by = VOLUME. No se envía en
                                  CURRENCY, cuyas monedas van en values.
                              time_period_repeat_amount:
                                type: integer
                                example: 1
                                description: >-
                                  TIME_PERIOD y VOLUME_PAYMENTS_LIMIT: cada
                                  cuántas unidades de tiempo de
                                  time_period_repeat_frequency (programación), o
                                  la duración de una ventana DAILY en días, de 1
                                  a 90 (limit).
                              time_period_repeat_frequency:
                                type: string
                                enum:
                                  - DAILY
                                  - WEEKLY
                                  - MONTHLY
                                  - QUARTERLY
                                  - YEARLY
                                description: >-
                                  TIME_PERIOD: unidad de recurrencia.
                                  VOLUME_PAYMENTS_LIMIT: período del límite,
                                  DAILY, MONTHLY o QUARTERLY.
                              time_period_repetition_days:
                                type: array
                                items:
                                  type: string
                                  enum:
                                    - MONDAY
                                    - TUESDAY
                                    - WEDNESDAY
                                    - THURSDAY
                                    - FRIDAY
                                    - SATURDAY
                                    - SUNDAY
                                description: >-
                                  Solo TIME_PERIOD. Días de la semana a los que
                                  se aplica la programación; requiere una
                                  frecuencia.
                              time_period_start_time:
                                type: string
                                example: '09:00:00'
                                description: >-
                                  Solo TIME_PERIOD. Inicio de la ventana horaria
                                  diaria (HH:mm:ss), junto con
                                  time_period_end_time.
                              time_period_end_time:
                                type: string
                                example: '18:00:00'
                                description: >-
                                  Solo TIME_PERIOD. Fin de la ventana horaria
                                  diaria (HH:mm:ss), inclusive.
                              timezone:
                                type: string
                                example: '-03:00'
                                description: >-
                                  Desfase UTC. TIME_PERIOD: desfase con el que
                                  se lee la programación (por defecto, el
                                  desfase de values[0]). VOLUME_PAYMENTS_LIMIT:
                                  desfase en horas completas donde comienzan los
                                  períodos (por defecto, +00:00).
                              limit_by:
                                type: string
                                enum:
                                  - PAYMENTS
                                  - VOLUME
                                description: >-
                                  Solo VOLUME_PAYMENTS_LIMIT. Cuenta pagos
                                  (predeterminado) o suma montos en la moneda.
                              payments_count:
                                type: string
                                enum:
                                  - ALL
                                  - SUCCEEDED
                                description: >-
                                  Solo VOLUME_PAYMENTS_LIMIT. Qué pagos cuentan
                                  para el límite. El valor predeterminado es
                                  ALL.
                          description: >-
                            Condiciones combinadas con AND lógico. Consulta
                            Routing Conditions.
                        route:
                          type: object
                          description: >-
                            Misma estructura que default_route, incluidos
                            start_split, output[].next_split y los pasos de
                            acción.
                  created_at:
                    type: string
                    format: date-time
                    example: '2026-05-12T14:30:00Z'
                  updated_at:
                    type: string
                    format: date-time
                    example: '2026-05-12T14:30:00Z'
        '400':
          description: Solicitud incorrecta
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ROUTING_VALIDATION_FAILED
                  messages:
                    type: array
                    items:
                      type: string
                    example:
                      - Validation failed for update
        '401':
          description: No autorizado
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: NOT_AUTHENTICATED
                  messages:
                    type: array
                    items:
                      type: string
                    example:
                      - Not authenticated
        '404':
          description: No encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ROUTING_NOT_FOUND
                  messages:
                    type: array
                    items:
                      type: string
                    example:
                      - Routing '...' was not found
        '409':
          description: Conflicto
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ROUTING_VERSION_CONFLICT
                  messages:
                    type: array
                    items:
                      type: string
                    example:
                      - Another concurrent PATCH won the publish race
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: PUBLIC-API-KEY
      x-default: <Your PUBLIC-API-KEY>
    sec1:
      type: apiKey
      in: header
      name: PRIVATE-SECRET-KEY
      x-default: <Your PRIVATE-SECRET-KEY>

````

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