Saltar al contenido principal
POST
Crear un enrutamiento
Crea un enrutamiento para un par (account_id, payment_method). Cada enrutamiento hace referencia a conexiones mediante su connection_id. Asegúrate de que tus conexiones estén creadas y ACTIVE para el payment_method solicitado antes de llamar a enrutamiento. Las salidas que hacen referencia a un grupo de rechazo, de Merchant Advice Code o de exitosos mediante group_id requieren que ese grupo también exista en la cuenta: consulta Grupos de resultados.

Cuerpo

string (UUID)
requerido
El ID de la cuenta de comercio a la que se aplica esta regla de enrutamiento.
enum
requerido
Ejemplo: CARD, PIX, WALLET. Inmutable por enrutamiento: para enrutar un método distinto, crea un nuevo 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 (por ejemplo, CARD).
string
Etiqueta del enrutamiento.
object
La lógica de enrutamiento predeterminada, con la forma descrita en Obtener 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

Cuerpo

application/json
account_id
string<uuid>
requerido
Ejemplo:

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

payment_method
string
requerido
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

Creado

id
string
Ejemplo:

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

account_id
string
Ejemplo:

"acc-uuid"

payment_method
string
Ejemplo:

"CARD"

name
string
Ejemplo:

"Card routing"

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"