Saltar al contenido principal
PATCH
Actualizar un enrutamiento
Reemplaza la configuración completa del enrutamiento. El cuerpo tiene la misma estructura que Crear un enrutamiento: 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:

Parámetros de ruta

string
requerido
El id devuelto por Crear un enrutamiento.

Cuerpo

string (UUID)
requerido
La cuenta a la que pertenece el enrutamiento. Debe coincidir con la cuenta del enrutamiento.
enum
requerido
Debe coincidir con el payment_method del enrutamiento.
string
requerido
Etiqueta de formato libre.
object
requerido
La ruta que se usa cuando ningún condition_sets[] coincide.
object[]
Opcional. Ordenados por sort_number: gana el primer conjunto que coincida.

Respuesta

string
Identificador único del enrutamiento.
string
Identificador único de la cuenta.
enum
El método de pago al que se aplica este enrutamiento (p. ej., CARD).
string
Etiqueta del enrutamiento.
object
La lógica de enrutamiento predeterminada, con la estructura descrita en Consultar un enrutamiento.
object[]
Lógica condicional opcional.
string
Marca de tiempo ISO 8601.
string
Marca de tiempo ISO 8601.

Errores

Autorizaciones

PUBLIC-API-KEY
string
header
predeterminado:<Your PUBLIC-API-KEY>
requerido
PRIVATE-SECRET-KEY
string
header
predeterminado:<Your PRIVATE-SECRET-KEY>
requerido

Encabezados

X-Idempotency-Key
string<uuid>
requerido

Parámetros de ruta

routing_id
string<uuid>
requerido

Cuerpo

application/json
account_id
string<uuid>
requerido

Debe coincidir con la cuenta del enrutamiento.

Ejemplo:

"7825fc5e-e50a-4248-9ae8-5d3786afb0be"

payment_method
string
requerido

Debe coincidir con el payment_method del enrutamiento.

Ejemplo:

"CARD"

name
string
requerido
Ejemplo:

"Card routing"

default_route
object
requerido
condition_sets
object[]

Opcional. Ordenado por sort_number; gana el primer conjunto que coincida.

Respuesta

OK

id
string
Ejemplo:

"8f2c1d3e-4b5a-4c7d-8e9f-0a1b2c3d4e5f"

account_id
string
Ejemplo:

"acc-uuid"

payment_method
string
Ejemplo:

"CARD"

name
string
Ejemplo:

"Updated Card routing v2"

default_route
object
condition_sets
object[]
created_at
string<date-time>
Ejemplo:

"2026-05-12T14:30:00Z"

updated_at
string<date-time>
Ejemplo:

"2026-05-12T14:30:00Z"