Skip to main content

Documentation Index

Fetch the complete documentation index at: https://transfiya.me/llms.txt

Use this file to discover all available pages before exploring further.

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 signerSchema aplicadaDescripción
BUSINESSBUSINESSRepresenta 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:
NombreValor
Cuenta de ahorrossvgs
Cuenta corrientecacc
Depósito de bajo montodbmo
Depósito ordinariodord
Depósito inclusivo bajo montodbmi
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:

EtiquetaDescripciónTipoLongitudObligatoriedad
aliasTypeTipo de llave: ACCOUNTTextoN/ASi
aliasValueValor de la llave. Ej: svgs:44255107106500@1001Texto1-Máximo 34 carácteresSi
typeTipo de signer: BUSINESSTextoN/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
bankAccountTypeNúmero de cuenta, admite: SVGS, TRAS,CACC,DBMO,DORD, DBMITexto1-4Si
bankAccountNumberNúmero de la cuentaTexto1-Máximo 34 dígitosSi
routerReferenceIdentificador de billetera del banco en Transfiya.Texto1- Máximo 34 caracteres alfanuméricos, debe comenzar con $Si