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”:
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"
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 |
