​
Introducción

El flujo regulatorio exige la resolución de llaves como requisito previo al inicio de cualquier transferencia, constituyendo el cambio fundamental para los participantes de Transfiya. Actualmente, el sistema Transfiya permite a los usuarios realizar transferencias monetarias a llaves como ser el numero de teléfono, lo que simplifica significativamente tanto la experiencia de usuario como el proceso de incorporación al sistema. Transfiya permite el envío de transferencias directamente a los signers, lo que permite completar transacciones de forma inmediata sin requerir la aceptación del destinatario. Este último modelo, regulado por la normativa Bre-B, establece como obligatoria la resolución de la llave antes de proceder con cualquier operación de transferencia. Cualquier nuevo participante puede adoptar el modelo regulado y, simultáneamente, continuar enviando y recibiendo transferencias con los participantes existentes, independientemente de si éstos han migrado al nuevo flujo regulado.

​
Flujo regulado

Los cambios de regulación requiren resolución de llaves antes de iniciar una transferencia. Si no se encuentra la llave activa, significa que el usuario no está registrado en el sistema y la transferencia no puede procesarse bajo el modelo regulado. Los participantes pueden migrar al nuevo flujo de forma independiente, sin necesidad de esperar otros participantes.
Las transferencias a billeteras con aceptación seguirán funcionando hasta la implementación completa de la regulación, garantizando la compatibilidad con los participantes actuales del sistema.

​
Ejemplos del API

​
Obtener signers para un alias

HTTP
POST /v1/signer/lookup.dice
Los signers pueden consultarse a través del endpoint v1/signer/lookup.dice, enviando los parametros correspondientes. Para verificar el estado de un signer, revise el campo labels.status
Para cubrir el caso de incorporación (onboarding), TransfiYa añade nuevas etiquetas al payload del firmante. Estas etiquetas representan las marcas de tiempo que los participantes necesitan recopilar:
  • received → el momento en que un participante recibió una solicitud del usuario para incorporarse, cuando el usuario hace clic en la aplicación
  • dispatched → el momento en que un participante envió una solicitud de incorporación a Transfiya, cuando se llama a la API de creación de firmante
ParameterTypeDescription
aliasValuestringAlias value.
receivedstringDate of reception in ISO 8601 with milliseconds precision.
dispatchedstringDate of dispatch in ISO 8601 with milliseconds precision.
curl --location '{{url}}/v1/signer/lookup.dice' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
"aliasValue": "@testing",
"received": "2025-04-10T15:49:15.015-05:00",
"dispatched": "2025-04-10T15:49:15.015-05:00"
}'

​
Códigos de Error

Error CodeHTTP StatusDescription
99400Unexpected server error
100403You don’t have permissions to access this method
100500Runtime error