Como crear una llave de tipo cuenta

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 datos 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. Tipos de Validaciones:

Tipo signer	Schema aplicada	Descripción
`BUSINESS`	BUSINESS	Representa una empresa o persona jurídica.

Sintaxis de Referencia para el campo aliasValue

bankAccountType: tipo de cuenta (en minúsculas), basado en los valores estándar de Transfiya.
bankAccountNumber: número de cuenta bancaria
routerReference: código de compensación o Bicfi válido del banco.

Este formato unificado garantiza consistencia y compatibilidad con los mecanismos de enrutamiento de Transfiya, facilitando la interoperabilidad entre participantes.

🏦 Tipos de Cuenta Soportados

A continuación se listan los tipos de cuenta reconocidos en Transfiya:

Nombre	Valor
Cuenta de ahorros	`svgs`
Cuenta corriente	`cacc`
Depósito de bajo monto	`dbmo`
Depósito ordinario	`dord`
Depósito inclusivo bajo monto	`dbmi`

Estos valores deben utilizarse exclusivamente en minúsculas y reflejan el tipo de cuenta real registrada por el firmante en el sistema financiero.

🌐 Referencia Bancaria

El identificador del banco (bankReference) debe ser el código de compensación o Bicfi válido, que permita una resolución clara y única del participante receptor.

✅ Ejemplo de referencia válida

svgs:44255107106500@7095

Ejemplo llave persona

A continuación se presenta un ejemplo de creación de una llave tipo ‘BUSINESS’ donde el tipo de Alias es “ACCOUNT”:

Request
Response

curl -X POST \
-H "x-api-key: <API_KEY>" \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"labels": {
"aliasType": "ACCOUNT",
"aliasValue": "svgs:1234@7095",
"type": "BUSINESS",
"name": "Jorge SAS",
"proprietary": "NIT",
"identification": "1010101010",
"bankAccountType": "SVGS",
"bankAccountNumber": "10010010001",
"routerReference": "$bancorojo"
},
"keeper": [{
"scheme": "ecdsa-ed25519",
"public": "0463e75c8b975f069813ca8e6c36c0b6fd246eac708affb7ed2c6480fa201defe8725322d6380ec66e94f6dcb49f635c0ca51296e48da4a12b3ec66582a1297adf"
}]
}' "<base URL>/v1/signer"

{
  "signer_id": "4c57ac39-16f0-489b-89d9-bddfcd352a36",
  "handle": "wRFmYXS2sP9ho9VCZ3j4FuP1j55ABeFvsF",
  "labels": {
    "aliasType": "ACCOUNT",
    "aliasValue": "svgs:1234@b7095,
    "type": "BUSINESS",
    "name": "Jorge SAS",
    "proprietary": "NIT",
    "identification": "1010101010",
    "bankAccountType": "SVGS",
    "bankAccountNumber": "10010010001",
    "routerReference": "$bancorojo"
    "created": "2024-10-11T11:59:24.241-05:00"
  },
  "keeper": [
    {
      "scheme": "ecdsa-ed25519",
      "public": "0463e75c8b975f069813ca8e6c36c0b6fd246eac708affb7ed2c6480fa201defe8725322d6380ec66e94f6dcb49f635c0ca51296e48da4a12b3ec66582a1297adf"
    }
  ],
  "error": {
    "code": 0,
    "message": "Success"
  }
}

Campos de entrada:

Etiqueta	Descripción	Tipo	Longitud	Obligatoriedad
aliasType	Tipo de llave: ACCOUNT	Texto	N/A	Si
aliasValue	Valor de la llave. Ej: svgs:44255107106500@1001	Texto	1-Máximo 34 carácteres	Si
type	Tipo de signer: BUSINESS	Texto	N/A	Si
name	Nombre para identificación	Texto	1-140 carácteres	Si
proprietary	Tipo de documento, admite: CC,CE,PA,TI,NUIP,NIT,OTR,PPT y PEP	Texto	1-4	Si
identification	Número de identificación	Texto	1-18 carácteres	Si
bankAccountType	Número de cuenta, admite: SVGS, TRAS,CACC,DBMO,DORD, DBMI	Texto	1-4	Si
bankAccountNumber	Número de la cuenta	Texto	1-Máximo 34 dígitos	Si
routerReference	Identificador de billetera del banco en Transfiya.	Texto	1- Máximo 34 caracteres alfanuméricos, debe comenzar con `$`	Si

Introducción

Guias de uso

APIs Banco

APIs Transfiya

Como crear una llave de tipo cuenta

Sintaxis de Referencia para el campo aliasValue

🏦 Tipos de Cuenta Soportados

🌐 Referencia Bancaria

✅ Ejemplo de referencia válida

Ejemplo llave persona

Campos de entrada:

​Sintaxis de Referencia para el campo aliasValue

​🏦 Tipos de Cuenta Soportados

​🌐 Referencia Bancaria

​✅ Ejemplo de referencia válida

​Ejemplo llave persona

​Campos de entrada:

Sintaxis de Referencia para el campo aliasValue

🏦 Tipos de Cuenta Soportados

🌐 Referencia Bancaria

✅ Ejemplo de referencia válida

Ejemplo llave persona

Campos de entrada: