@nicatech/capacitor-transaction-engine

Plugin de Capacitor para el módulo Transaction Engine del SDK BioIdentity de Trust Technologies.

Instalación

npm install @nicatech/capacitor-transaction-engine
npx cap sync

No se requiere configuración adicional de Cloudsmith ni registro manual en MainActivity.

Uso

import { TransactionEngine } from '@nicatech/capacitor-transaction-engine';

const result = await TransactionEngine.createTransaction({
  dni: '12345678-9',
  authorizationMethod: 'KYC_REGISTER',
  country: 'CHILE',
  tries: 3,
});

if (result.success) {
  console.log('Transaction ID:', result.transactionId);
} else {
  console.error('Error:', result.error);
}

API

createTransaction(options)

Crea una transacción biométrica en los servidores de Trust Technologies.

Parámetros:

| Parámetro | Tipo | Requerido | Default | Descripción | |-----------|------|-----------|---------|-------------| | dni | string | ✅ | — | Número de identificación del usuario | | authorizationMethod | string | ✅ | — | Método de autorización (ver TransactionFactory para opciones) | | country | string | ❌ | 'CHILE' | Código de país | | tries | number | ❌ | 3 | Intentos permitidos | | challenges | number | ❌ | 0 | Número de desafíos de liveness | | alternativeFlow | string | ❌ | null | Flujo alternativo | | docVerification | boolean | ❌ | null | Requiere verificación de documento |

Valores de authorizationMethod (definidos en TransactionFactory):

• kyc_register
• kyc_nfc_register
• kyc_register_simple
• step_validation_process
• nfc_fingerprint_moc
• nfc_only_process
• biometric_verify

Retorna:

{
  success: boolean;
  transactionId?: string;  // UUID cuando success === true
  error?: string;          // Mensaje de error cuando success === false
}

Plataformas

| Plataforma | Soporte | |------------|---------| | Android | ✅ | | iOS | ❌ (no implementado) | | Web | ❌ (lanza error) |

Requisitos

• Capacitor 5.x o 6.x
• Android minSdkVersion 26+