Transacciones

La fase de Transacciones es puramente backend: tu servidor registra cada operación sensible (transferencia, alta de cuenta, evento de tarjeta, …) en la API de SmartID. Reglas, perfilamiento transaccional de usuario y reglas con IA evalúan cada evento en tiempo real y lanzan alertas por Webhooks.

Integración desde Backend

No se requieren cambios en el SDK. Desde tu servidor, envía un POST por operación al endpoint de Operation.

Alertas en tiempo real

Las anomalías detectadas por el motor de reglas se entregan a tu sistema vía el endpoint de Webhooks. Webhooks →

Registrar Operación

Registra un evento de transacción u operación para el motor de prevención de fraude transaccional. Cada operación debe estar asociada a una sesión de login activa usando los mismos valores de channelId, account.client y account.session enviados en la solicitud de Login.

Atributos de la Solicitud

channelId integer required

Identificador numérico del canal digital.

transaction object required ▾

Detalles de la transacción.

category string required — Category (e.g., "add account", "transfer")

type string required — Sub-type (e.g., "ach", "third parties")

description string optional — Description or comment

reference string optional — Transaction reference ID

date string optional — Optional date

details object optional — Key-value dictionary for additional data

account object required ▾

Usuario que ejecuta la transacción.

client string required — User ID in format "codeuser"

session string required — Session identifier

email string optional — User email

phoneNumber string optional — User phone

accountNumber string optional — Encrypted account number

bank string optional — Encrypted bank identifier

order object conditional

Requerido si la operación involucra un monto monetario.

amount decimal required — Operation amount

currency string required — Currency code (e.g., "GTQ", "USD")

timestamp string required

Fecha y hora de la transacción en formato ISO 8601.

accountTo object optional ▾

Beneficiario de la transacción.

client string — Beneficiary ID

email string — Beneficiary email

accountNumber string — Destination account (encrypted)

bank string — Destination bank (encrypted)

creditCard object optional ▾

Información de tarjeta de crédito si aplica.

bin string — Card BIN

hash string — Card hash

last4Digits string — Last 4 digits

token string — Card token

Endpoint HTTP

POST /api/v5/analytics/app/operation

JSON

{
  "channelId": 1,
  "transaction": {
    "category": "add account",
    "type": "ach",
    "description": "account name",
    "reference": "operation reference",
    "date": "datetime",
    "details": {
      "key": "value"
    }
  },
  "account": {
    "client": "1564651jlopez",
    "clientRefId": 0,
    "clientRefIdStr": "",
    "email": "",
    "phoneNumber": "",
    "session": "7gf7asdf4as7f",
    "accountNumber": "g489as4fa57gwad4a5g==",
    "bank": "ga8sdasfgasga=="
  },
  "order": {
    "amount": 0.00,
    "currency": "GTQ"
  },
  "accountTo": {
    "client": "",
    "accountNumber": "",
    "bank": ""
  },
  "creditCard": {
    "bin": "",
    "hash": "",
    "last4Digits": "",
    "token": ""
  }
}

Configurar Webhooks Recibe payloads de alertas y ejecuta acciones →