​
Envio con liquidacion en MOL

​
Resumen de cambios para entidad

Para cumplir con el flujo regulatorio, se usaría la misma integración del participante utilizando el concepto de Transfer para iniciar transferencias.
Las interfaces de interacción no cambian para la entidad, ya que la plataforma cumple actualmente con la mayoría de los requisitos regulatorios.
La liquidación con MOL y el manejo de tiempos ya están gestionados por la plataforma y no requieren cambios por parte de los participantes. Los participantes únicamente deben asegurar para envio de transferencias:
  • Utilizar API de transferencias: Mantener la misma integración para iniciar transferencias
  • Especificar tipo de transferencia: Durante la marcha blanca, identificar las transferencias que se comunican con MOL usando “label.type”:“SENDMOL”
  • Incluir marcas de tiempo: Agregar marca de tiempo externa a la plataforma: “dispateched” para notificar tiempo de inicio de transferncia

​
Origen y destino de transferencia

Las transferencias reguladas se definen como transferencias de cuenta a cuenta. Estas transacciones no deberían diferenciarse de las transferencias actuales entre cuentas en Transfiya.
La resolución de llaves debe realizarse antes de crear una transferencia.
El modelo actual de Transfiya facilita las transferencias de cuenta a cuenta mediante el uso de credenciales de pago (signer handles) como origen y destino de una transferencia. En caso de modelo regulado origen y destino de transferencia son conocidos por proceso previo de resolucion de llaves y se realiza una cuenta a cuenta. Mas sobre signers.

​
Concepto Transfer

Transfiya utiliza el concepto de “transfer” para iniciar pagos en el sistema agnosticos a caso a uso o tipo de transferencia.
El uso del modelo de transfer para iniciar pagos en el sistema permite emplear el mismo protocolo y REST API para cualquier caso de uso o flujo de dinero, incluyendo el nuevo flujo regulatorio.

​
Identificador de flujo

Cuando se inicia un transfer se activa uno de los flujos de pago orchestrados por la plataforma. Flujo que se va usar en la marcha blanca y despues de 1 de Semptiembre para flujo regulatorio es SENDMOL.
​
labels.type
string[SENDMOL]
Tipo de transferencia.
Cambio principal de este flujo comparado con envio no regulado es en modelo de liquidacion de fondos con MOL y confirmacion de la cuenta. Mas sobre flujos pueden conocer aqui.

​
Ejemplo de un transfer regulatorio

Para realizar un transfer con modelo regulatorio es necesario definir que el modelo de flujo y asegurar envio de marca de timepo de inicio. Los cambios en el modelo son mostrados en el ejemplo de diferencias en codigo. 
curl -X POST \
-H "Content-Type: application/json" \
-H "x-api-key: <API_KEY>" \
-H "Authorization: Bearer <TOKEN>" \
-d '{
"source": "wXxwpxB32saqfmfMxAQD4SVWWhhn6akLC2",
"target": "wRFmYXS2sP9ho9VCZ3j4FuP1j55ABeFvsF",
"symbol": "$tin",
"amount": "100",
"labels": {
"description": "Payment for lunch",
"domain": "tin",
"type": "SENDMOL",
"sourceChannel": "APP",
"tx_id": "20250114890915944TFY123456789012345",
"received": "2025-01-14T20:40:57.322-05:00",
"dispatched": "2025-01-14T20:40:58.322-05:00",
"deviceFingerPrint": {
  "hash": "26fff5af6441f8e15a71e8d62c361714484b1b308c99e8eb68ca85e2a7e0dc58",
  "ipAddress": "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
  "country": "Colombia",
  "city": "Bogotá",
  "mobileDevice": "990000862471854",
  "SIMCardId": "8991101200003204510",
  "model": "Huawei Mate 20 Pro",
  "operator": "Bharti Airtel Limited"
}
}
}' "<TRANSFIYA URL>/v1/transfer"
tx_id: identificación única asignada por el SPBVI Originador para identificar inequívocamente la transacción en el ecosistema. Esta identificación se transmite sin cambios, a lo largo del flujo de pago después de que el SPBVI Originador asigna la identificación:“YYYYMMDD#########TFY000000000000005”
  • YYYYMMDD: fecha (8 caracteres), en horario local y que corresponde a la fecha del momento en que el SPBVI originador recibe la confirmación de la orden de pago y/o transferencia de fondo inmediata por parte del Participante Originador.
  • NIT: (9 caracteres - #########) NIT del Participante Originador (sin dígito de verificación) o código asignado por el BR.
  • Sigla del SPBVI Originador TFY: Corresponde a la abreviación del Sistema de Pago de Bajo ValorInmediato Originador.
  • Secuencia (15 dígitos): Número ascendente que debe ser único para cada fecha en formato “YYYYMMDD”. Si el valor tiene menos de 15 dígitos, se debe completar con ceros a la izquierda como en el ejemplo.
Para iniciar órdenes de pago en Bre-B, no es obligatorio que el signer de origen incluya todas las etiquetas regulatorias.
Sin embargo, es fundamental garantizar un conjunto mínimo de campos para asegurar el correcto envío del dinero:
  • firstName
  • lastName
  • bankAccountNumber
  • bankAccountType
  • proprietary
  • identification
  • bankId
  • targetSpbviCode
  • type
  • routerReference
Es importante tener en cuenta que se puede continuar utilizando la estructura anterior, siempre que se aseguren estos campos mínimos. Alternativamente, se puede emplear la estructura basada en llaves que ya los incluye. En este último caso, la entidad deberá considerar los sus controles y excepciones aplicables según el estado del signer.

​
Aceptación en el flujo regulado

En el modelo regulado, la aceptación de una transferencia no depende de una acción explícita por parte del usuario final, como podría suceder en flujos tradicionales. Sin embargo, sí requiere de una validación formal por parte de la entidad financiera que actúa como banco receptor. Este paso de aceptación es obligatorio antes de continuar con el procesamiento y consiste en que la entidad receptora verifique que la cuenta destino:
  • Existe y está activa.
  • Está habilitada para recibir pagos.
  • Cumple con los requisitos establecidos por la regulación, como los límites de monto o tipo de moneda.
Una vez realizada esta validación, el banco destinatario confirma la aceptación utilizando el mecanismo estándar ya existente en TransfiYa para flujos asincrónicos. Esta aceptación por parte de la entidad equivale a una aprobación regulatoria que habilita a continuar con la operación de crédito y la posterior liquidación a través del MOL.
Este modelo permite cumplir con la normativa vigente sin necesidad de cambiar los componentes fundamentales de la arquitectura de TransfiYa, facilitando así la adaptación de los bancos al nuevo flujo SPI.

​
Modelo de liquidación

Una vez que MOL entre en funcionamiento, cada transferencia deberá enviarse a MOL para su procesamiento y se pausará el procesamiento interno hasta recibir una llamada de continuación desde MOL. Transfiya ya cuenta con un sistema de procesamiento asíncrono que continúa mediante llamadas API. El procesamiento de transferencias está implementado como un flujo de múltiples pasos, por lo que para soportar este cambio solo necesitamos extender el sistema internamente añadiendo nuevos pasos asíncronos al proceso, lo cual resulta sencillo gracias a la arquitectura actual. Mas sobre liquidación pueden ver aca Cambios de flujo que incluyen llamadas a MOL e orchestraacion con otros sistemas de pago se manejan por parte de plataforma usando orchestracion de flujos.