​
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: “initiated” 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": "$573002414263",
+   "target": "wfvmRir8XxRtoEuUBDkv3BP4T7BQezwm1f",
    "symbol": "$tin",
    "amount": "100",
    "labels": {
      "description": "Envio prueba mol",
      "domain": "tin",
+     "type": "SENDMOL",
      "sourceChannel": "APP",
+     "tx_id": "20250114890915944TFY123456789012345",
+     "initiated": "2025-01-14T20:40:57.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"
      }
    }
  }' "URL/v1/transfer"

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

Como administrar llavesSobre Flujos