Skip to main content

Introducción

Ahora, el Directorio Federado de Transfiya permite la creación de signer genérico, las cuales se utilizan en el flujo de transferencias de cuenta a cuenta cuando la entidad receptora no ha implementado el proceso de onboarding automático.
Estos signers permiten ejecutar transferencias sin necesidad de que el signer del receptor sea creado en tiempo real.
La entidad receptora debe registrar este signer genérico una única vez y quedará disponible para su uso en futuras operaciones.

Ejemplo de creación de Signer

Para la creación de llaves, se utilizará la interfaz de aplicación destinada a la creación de signers. La plataforma Transfiya utiliza tipos de signers y esquemas dinámicos para garantizar la integridad y consistencia de los datos en toda la plataforma. Esto incluye reglas de validación para diversos campos dentro del sistema.
Tipo signerSchema aplicadaDescripción
GENERICGENERICRepresenta una signer genérico de una Entidad Participante

Ejemplo de creación: Signer Genérico

A continuación se presenta un ejemplo de creación de una llave tipo ‘GENERIC’:
  • Request
  • Response
curl -X POST \
 -H "x-api-key: <API_KEY>" \
 -H "Authorization: Bearer <TOKEN>" \
 -H "Content-Type: application/json" \
 -d '{
   "labels": {
     "type": "GENERIC",
     "name": "Generico",
     "proprietary": "NIT",
     "identification": "111111111",
     "routerReference": "$bancorojo",
     "bankId": "111111111",
   },
   "keeper": [{
     "scheme": "ecdsa-ed25519",
     "public": "0463e75c8b975f069813ca8e6c36c0b6fd246eac708affb7ed2c6480fa201defe8725322d6380ec66e94f6dcb49f635c0ca51296e48da4a12b3ec66582a1297adf"
   }]
 }' "<base URL>/v1/signer"

Campos de entrada:

EtiquetaDescripciónTipoLongitudObligatoriedad
typeTipo de signer: GENERICTextoN/ASi
nameNombre para identificaciónTexto1-140 carácteresSi
proprietaryTipo de documento, admite: CC,CE,PA,TI,NUIP,NIT,OTR,PPT y PEPTexto1-4Si
identificationNúmero de identificaciónTexto1-18 carácteresSi
routerReferenceIdentificador de billetera del banco en Transfiya.Texto1- Máximo 34 caracteres alfanuméricos, debe comenzar con $Si
bankIdRepresenta un número NIT del banco sin dígito de verificación o un código asignado por BanRep.Texto1-Máximo 9 caracteres numéricosSi