​
Modelo de Aceptación

El modelo actual de Transfiya permite enviar transferencias a destinos que no son registrados previamente en la plataforma.

Modelo de aceptacion es una ventaja de plataforma para poder incluir usuarios que no estan registrados previamente en la plataforma.

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.

​
Flujo actual transfiya

Flujo actual usa un modelo de confirmacion de origen y destino.

​
Notificación a status

Cuando una transferencia se encuentra en estado PENDIENTE, Minka intentará notificar a todas las entidades bancarias que posean al menos una cuenta registrada en el sistema.

Si un banco ha desactivado la opción de notificación (mencionada anteriormente), dicho banco no recibirá la notificación.

La llamada al endpoint /status comparte el objeto de Transferencia en base de criterios de aceptación definidos.

curl -X POST /status
 -H "x-api-key: <API_KEY>" \
 -H "Authorization: Bearer <TOKEN>" \
 -H "Content-Type: application/json" \
 -d '
{
  "source": "wXxwpxB32saqfmfMxAQD4SVWWhhn6akLC2",
  "target": "wfvmRir8XxRtoEuUBDkv3BP4T7BQezwm1f",
  "amount": "100.00",
  "symbol": "$tin",
  "labels": {
    "hash": "PENDING",
    "type": "SEND",
    "domain": "tin",
    "flowId": "Lf13jsK83omPv3bOt",
    "status": "PENDING",
    "tx_ref": "Lf13jsK83omPv3bOt",
    "tx_mol": "20250114890915944TFY123456789012345", // nuevo campo
    "initiated": "2025-01-14T20:40:57.322-05:00",
    "created": "2025-01-14T20:40:57.322-05:00",
    "updated": "2025-01-14T20:40:57.322-05:00",
    "description": "DEV - SEND trx 01",
    "sourceChannel": "APP",
    "deviceFingerPrint": {
      "city": "Bogotá",
      "hash": "26fff5af6441f8e15a71e8d62c361714484b1b308c99e8eb68ca85e2a7e0dc58",
      "model": "Huawei Mate 20 Pro",
      "country": "Colombia",
      "operator": "Bharti Airtel Limited",
      "SIMCardId": "8991101200003204510",
      "ipAddress": "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
      "mobileDevice": "990000862471854"
    }
  },
  "snapshot": {
    "source": {
      "signer": {
        "handle": "wXxwpxB32saqfmfMxAQD4SVWWhhn6akLC2",
        "labels": {
          "name": "Jorge Alejandro Fernandez Garcia",
          "proprietary": "CC",
          "identification": "1010101010",
          "bankAccountType": "SVGS",
          "bankAccountNumber": "12345654321",
   	      "bankId": "891234918",
          "targetSpbviCode": "TFY"
        }
      },
    },
    "target": {
      "signer": {
           "handle": "wfvmRir8XxRtoEuUBDkv3BP4T7BQezwm1f",
        "labels": {
          "name": "Jorge Alejandro Fernandez Garcia",
          "proprietary": "CC",
 	        "identification": "1010101010",
          "bankAccountType": "SVGS",
          "bankAccountNumber": "12345654321",
   	      "bankId": "891234918",
          "targetSpbviCode": "TFY",
        }
      },
    }
  },
  "error": {
    "code": 0,
    "message": "Success"
  },
  "action_id": "35de4d3d-3aba-4fb3-b110-d004ce2aabb2",
  "id": "35de4d3d-3aba-4fb3-b110-d004ce2aabb2"
}

La mayoría de los participantes actualmente utiliza un modelo que consulta periódicamente las transferencias pendientes. El uso del endpoint /status reduce significativamente la carga en la infraestructura tanto del banco como de la plataforma.

​
Aceptación en flujo regulado

El flujo regulado requiere un paso previo a la aceptación de la transferencia que incluye la validación de la cuenta destino y la aceptación de la transferencia por parte del destinatario.

Aunque no existe una aceptación explícita por parte del usuario, las transferencias reguladas requieren una aprobación formal por parte de la entidad destinataria

La entidad luego de confirmar la cuenta destino acepta la transfernencia usando el flujo actual de aceptación de transferencias.