Transacción

Representa una transferencia SPEI, ya sea saliente (cargo) o entrante (abono).

Schema

Identificación

Campo	Tipo	Descripción
id	INT	ID interno
user_id	VARCHAR	UUID del usuario
parent_id	VARCHAR	UUID del usuario raíz (cuenta principal)
account_id	INT	FK a account (cuenta origen)
dest_account_id	INT	FK a account destino (si es cuenta Finalitix)
dest_contact_id	INT	FK a contact destino
batch_id	INT	FK a lote de transacciones (si aplica)
root_id	VARCHAR	ID de la transacción raíz en pagos internos

Montos

Campo	Tipo	Descripción
amount	DECIMAL	Monto de la transacción en MXN
account_amount_before	DECIMAL	Saldo de la cuenta antes de la transacción
account_amount_after	DECIMAL	Saldo de la cuenta después de la transacción
currency	VARCHAR	Siempre "MXN"
monetary_instrument	VARCHAR	Instrumento monetario (siempre "01")

Estados

Campo	Tipo	Valores
type	ENUM	cargo (saliente) / abono (entrante)
state	VARCHAR	draft, process, liquidation, cancel
api_state	VARCHAR	borrador, enviada, Liquidación, Cancelación, Devolución
limit_state	VARCHAR	Ver tabla de estados de aprobación

Estados de aprobación (limit_state)

Valor	Significado
approved	Aprobada automáticamente (dentro de límites)
to_approve	Requiere aprobación del usuario raíz
root_approved	Aprobada por el usuario raíz
director_to_approve	Requiere aprobación del director
director_approved	Aprobada por el director
director_denied	Rechazada por el director
denied	Rechazada

Datos del ordenante

Campo	Tipo	Descripción
account_number	VARCHAR(18)	CLABE del ordenante
tipoCuentaOrdenante	INT	Tipo de cuenta (40 = CLABE)
nombreOrdenante	VARCHAR	Nombre en mayúsculas, sin acentos
rfcCurpOrdenante	VARCHAR	RFC o CURP del ordenante
institucionOrdenante	INT	Código de institución STP

Datos del beneficiario

Campo	Tipo	Descripción
dest_account_number	VARCHAR(18)	CLABE del beneficiario
tipoCuentaBeneficiario	INT	Tipo de cuenta del beneficiario
nombreBeneficiario	VARCHAR	Nombre del beneficiario
rfcCurpBeneficiario	VARCHAR	RFC o CURP del beneficiario
institucionBeneficiaria	INT	Código de institución STP del beneficiario

Metadatos STP

Campo	Tipo	Descripción
api_id	INT	ID de la orden en STP
tracking_key	VARCHAR	claveRastreo SPEI
numericalReference	INT	Referencia numérica de 7 dígitos
sign	TEXT	Firma RSA de la orden (o folioCodi para abonos)
tipoPago	INT	Siempre 30
description	VARCHAR	Concepto de pago
fechaOperacion	VARCHAR	Fecha en formato YYYYMMDD
tsLiquidacion	BIGINT	Timestamp de liquidación en milisegundos

Geolocalización y seguridad

Campo	Tipo	Descripción
latitude	DECIMAL	Latitud del dispositivo al momento del cargo
longitude	DECIMAL	Longitud del dispositivo
ip	VARCHAR	IP del cliente
totp_validated	BOOLEAN	Si se validó con TOTP
totp_hashed	VARCHAR	Hash del TOTP usado
finalitix_payment	BOOLEAN	Si es pago de plan/servicio a Finalitix

Flujo de estados

SALIENTE (cargo):
  draft → (aprobación si necesaria) → process → enviada → Liquidación/Cancelación/Devolución

ENTRANTE (abono):
  Se crea directamente en estado "liquidation"