Procesamiento Inteligente de Pagos (Orquestador) — Guía para Clientes

Shinkansen ofrece un sistema de procesamiento inteligente de pagos que permite a los clientes controlar cómo se ejecutan sus transacciones. Dependiendo de sus necesidades, usted puede:

• Elegir exactamente el riel de pago que desea usar para cada transacción (control total).

• Delegar la decisión a Shinkansen, que aplicará reglas de enrutamiento optimizadas configuradas por nuestro equipo (ruteo automático inteligente).

Este artículo explica ambas modalidades, los rieles de pago disponibles, y cómo funciona internamente el procesamiento para que usted entienda qué esperar.

Rieles de Pago Disponibles (Chile)

Nota sobre transferencias intrabancarias: Cuando la cuenta origen y destino están en el mismo banco, los límites de monto de TEF generalmente no aplican.

Opción A: Riel Explícito (Control Total)

¿Cómo funciona?

Usted especifica directamente el riel de pago en cada transacción enviada a través de la API o archivo Excel. Shinkansen respeta su decisión sin aplicar ningún ruteo automático.

¿Cuándo usar esta opción?

• Cuando su equipo de tesorería sabe exactamente qué riel necesita para cada pago.

• Cuando tiene políticas internas que determinan el riel según el tipo de operación.

• Cuando necesita control total sobre costos y tiempos de liquidación.

Cómo enviar el riel en la API

En el payload de creación de payout order, incluya el campo payment_rail con el identificador del riel deseado:

{
  "payout_order": {
    "amount": "15000000",
    "currency": "CLP",
    "payment_rail": "cl_tef",
    "execution_mode": "immediate",
    "recipient_name": "Proveedor SpA",
    "recipient_account": "00123456789",
    "recipient_fin_id": "cl_banco_bci"
  }
}

Valores disponibles para payment_rail

Valores disponibles para execution_mode

Importante: Si usted especifica un riel explícito, Shinkansen lo usará tal cual. Es responsabilidad del cliente asegurarse de que el riel elegido sea compatible con el monto y tipo de transferencia. Por ejemplo, una TEF interbancaria por CLP 50M podría ser rechazada por el banco si excede el límite del riel.

Opción B: Ruteo Automático Inteligente

¿Cómo funciona?

Usted envía sus pagos con payment_rail = "default" y Shinkansen determina automáticamente el mejor riel según reglas configuradas por nuestro equipo de operaciones. Estas reglas consideran:

• Monto de la transacción

• Tipo de transferencia: intrabancaria (mismo banco) o interbancaria (bancos distintos)

• Modo de ejecución: inmediato o diferido

¿Cuándo usar esta opción?

• Cuando procesa volúmenes altos de pagos con montos variados.

• Cuando quiere optimizar costos automáticamente (evitar LBTR innecesarios).

• Cuando no quiere preocuparse por los límites de cada riel.

Cómo activar el ruteo automático

Simplemente envíe payment_rail como "default" (o no lo incluya, ya que "default" es el valor por defecto):

{
  "payout_order": {
    "amount": "50000000",
    "currency": "CLP",
    "payment_rail": "default",
    "execution_mode": "immediate",
    "recipient_name": "Proveedor SpA",
    "recipient_account": "00123456789",
    "recipient_fin_id": "cl_banco_santander"
  }
}

También puede combinar: especificar execution_mode pero dejar payment_rail en "default", o viceversa. El sistema solo aplica ruteo automático sobre los campos que estén en "default".

¿Qué pasa después del enrutamiento?

Una vez determinado el riel de pago (ya sea por elección explícita o ruteo automático), el sistema ejecuta un pipeline de tres etapas:

Pipeline de Procesamiento

Etapa 1: Enrutamiento

Determina qué riel usar. Si usted eligió un riel explícito, esta etapa simplemente lo respeta. Si envió "default", aplica las reglas configuradas.

Etapa 2: Procesamiento (Trozado)

Si el monto excede el límite del riel asignado, el sistema puede dividir automáticamente la transacción en múltiples transacciones más pequeñas. Esto le permite enviar pagos de alto valor por rieles económicos sin preocuparse por los límites.

Ejemplo: Un pago de CLP 80M por TEF (límite CLP 7M interbancario) se divide automáticamente en 12 transacciones (11 × CLP 7M + 1 × CLP 3M).

Nota sobre LBTR: Los pagos por LBTR nunca se dividen, ya que es un requerimiento regulatorio que LBTR procese transacciones individuales.

Cuando un pago es dividido, usted puede consultar los detalles en la respuesta de la API a través del campo split_details, que muestra las transacciones resultantes y sus montos.

Etapa 3: Empaquetado

Las transacciones se agrupan y formatean según los requerimientos del banco destino. Esto es transparente para usted: Shinkansen se encarga de empaquetar correctamente según las capacidades de cada banco.

Existen dos modos de empaquetado:

El modo de empaquetado es configurado por Shinkansen según las necesidades de su organización y las capacidades del banco.

Ejemplos Prácticos

Ejemplo 1: Pago intrabancario de alto valor

Escenario: Su empresa tiene cuenta en BCI y paga CLP 15M a un proveedor que también tiene cuenta en BCI.

Resultado: Como es intrabancario, no hay límite de monto para TEF. Se ejecuta como 1 TEF por CLP 15M. Costo bajo.

Ejemplo 2: Pago interbancario alto valor, diferido

Escenario: Pago de CLP 50M desde BCI a Santander. No es urgente.

Resultado: El monto supera el límite TEF interbancario y el pago es diferido → se enruta a CCA Batch. Liquida al día siguiente a las 9:00 AM. Costo bajo.

Ejemplo 3: Pago interbancario alto valor, inmediato

Escenario: Mismo pago de CLP 50M desde BCI a Santander, pero urgente.

Resultado: Monto alto + interbancario + inmediato → LBTR. Se ejecuta el mismo día. Costo alto (200x TEF), pero la urgencia lo justifica.

Ejemplo 4: Pago alto valor con trozado automático

Escenario: Pago de CLP 80M desde BCI a Banco Security, inmediato. La regla configurada indica que montos menores a CLP 100M interbancarios se procesan como TEF trozada en lugar de LBTR (para ahorrar costos).

Resultado:

1. Enrutamiento: La regla asigna TEF con trozado (en vez de LBTR).

2. Procesamiento: Se divide en 12 transacciones (11 × CLP 7M + 1 × CLP 3M).

3. Empaquetado: Se envían como 12 TEFs individuales.

Costo: 12 × TEF, que sigue siendo significativamente menor que 1 LBTR. Su proveedor recibe los CLP 80M completos.

Ejemplo 5: Nómina con múltiples rieles

Escenario: Su empresa envía 9 pagos desde BCI en una sola nómina.

Resultado del procesamiento:

Total: 9 pagos originales → 12 transacciones procesadas → despachadas en 8 mensajes al banco.

Seguimiento y Visibilidad

Estado de las transacciones

Cada payout order tiene un estado que puede consultar vía API:

Detalle de trozado

Cuando una orden es dividida, la respuesta de la API incluye un campo split_details que muestra:

• Cantidad de transacciones resultantes

• Monto de cada transacción

• Estado individual de cada parte

Riel y modo de ejecución resueltos

La respuesta de la API siempre incluye los campos payment_rail y execution_mode con los valores finales utilizados, independientemente de si fueron especificados por usted o resueltos automáticamente.

Compromiso de Transparencia

El equipo comercial de Shinkansen se compromete a:

• Explicar las reglas configuradas para su organización antes de activarlas.

• Informar sobre los costos de cada riel. LBTR es significativamente más caro que TEF o CCA Batch.

• No enrutar a LBTR sin consentimiento: El ruteo automático nunca envía pagos a LBTR a menos que las reglas configuradas para su organización lo indiquen explícitamente.

Responsabilidades del cliente

• Las reglas de ruteo se configuran en conjunto con el equipo comercial de Shinkansen.

• Si elige riel explícito, es su responsabilidad seleccionar un riel compatible con el monto.

• LBTR tiene costos elevados: úselo solo cuando la urgencia lo justifica.

Preguntas Frecuentes

¿Puedo mezclar pagos con riel explícito y pagos con ruteo automático en una misma nómina?

Sí. Cada payout order se procesa de forma independiente. Puede enviar algunas con payment_rail: "cl_tef" y otras con payment_rail: "default" en el mismo batch.

¿Qué pasa si envío un pago por TEF que excede el límite del banco?

Si el ruteo automático está activo y hay reglas de trozado configuradas, el sistema dividirá automáticamente la transacción. Si usted especificó TEF explícitamente y no hay trozado configurado, el banco podría rechazar la transacción.

¿El trozado afecta la conciliación?

Cada transacción resultante del trozado mantiene trazabilidad con la orden original. El campo split_details en la API le permite reconciliar las partes con la orden completa.

¿Puedo cambiar las reglas de ruteo?

Las reglas son configuradas por el equipo de Shinkansen. Contacte a su ejecutivo comercial para solicitar cambios.

¿El ruteo automático funciona para otros países además de Chile?

Actualmente el ruteo automático inteligente está disponible para Chile. Para otros países, utilice riel explícito.

¿CCA Batch tiene algún riesgo?

CCA Batch liquida al día siguiente (T+1). Si necesita que el beneficiario reciba los fondos el mismo día, use TEF (montos dentro del límite) o LBTR (sin límite de monto).

Para consultas técnicas sobre la integración API, contacte al equipo de soporte de Shinkansen.

Para configuración de reglas de ruteo, contacte a su ejecutivo comercial.