Cómo registrar signer genérico

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 signer	Schema aplicada	Descripción
`GENERIC`	GENERIC	Representa 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": "Signer generico 1",
	"bankName": "Banco Rojo",
    "routerReference": "$bancorojo",
    "bankBicfi": "7095",
   },
   "keeper": [{
     "scheme": "ecdsa-ed25519",
     "public": "0463e75c8b975f069813ca8e6c36c0b6fd246eac708affb7ed2c6480fa201defe8725322d6380ec66e94f6dcb49f635c0ca51296e48da4a12b3ec66582a1297adf"
   }]
 }' "<base URL>/v1/signer"

{
  "signer_id": "4c57ac39-16f0-489b-89d9-bddfcd352a36",
  "handle": "wRFmYXS2sP9ho9VCZ3j4FuP1j55ABeFvsF",
  "labels": {
    "type": "GENERIC",
    "name": "Generico",
    "proprietary": "NIT",
    "identification": "1010101010",
    "bankAccountType": "SVGS",
    "bankAccountNumber": "12345654321",
    "bankId": "891234918",
    "routerReference": "$bancorojo",
    "createdBy": "$minka"        
  },
  "keeper": [
    {
      "scheme": "ecdsa-ed25519",
      "public": "0463e75c8b975f069813ca8e6c36c0b6fd246eac708affb7ed2c6480fa201defe8725322d6380ec66e94f6dcb49f635c0ca51296e48da4a12b3ec66582a1297adf"
    }
  ],
  "error": {
    "code": 0,
    "message": "Success"
  }
}

Campos de entrada:

Etiqueta	Descripción	Tipo	Longitud	Obligatoriedad
type	Tipo de signer: GENERIC	Texto	N/A	Si
name	Nombre para identificación	Texto	1-140 carácteres	Si
bankName	Nombre del banco	Texto	1-140 carácteres	Si
routerReference	Identificador de billetera del banco en Transfiya.	Texto	1- Máximo 34 caracteres alfanuméricos, debe comenzar con `$`	Si
bankBicfi	Representa el código de compensación del banco.	Texto	1-Máximo 4 caracteres numéricos	Si

Con base en lo anterior, para la creación de un signer de tipo GENERIC, donde el banco origen corresponde a Source y el banco destino a Target, se deberán crear dos signers independientes entre sí. Una vez creados, ambos deberán asociarse al wallet $Banco, aplicando de manera estricta la configuración estándar definida para este tipo de integración.

Request:

PUT https://ach-minka-stg.transferenciasinmediatas.com/v1/wallet/{{walletUser}}

Body:

{
"labels": {
"bankDomain" :"{{bankBicfi}}",
"targetGenericSigner": "{{targetGenericSigner}}",
"sourceGenericSigner": "{{sourceGenericSigner}}"
}
}

Introducción

Guias de uso

APIs Banco

APIs Transfiya

Cómo registrar signer genérico

Introducción

Ejemplo de creación de Signer

Ejemplo de creación: Signer Genérico

Campos de entrada:

Request:

Body:

​Introducción

​Ejemplo de creación de Signer

​Ejemplo de creación: Signer Genérico

​Campos de entrada:

​Request:

​Body:

Introducción

Ejemplo de creación de Signer

Ejemplo de creación: Signer Genérico

Campos de entrada:

Request:

Body: