diff --git a/boot/common-framework/src/main/java/com/klaro/acquirecore/framework/TxStatus.java b/boot/common-framework/src/main/java/com/klaro/acquirecore/framework/TxStatus.java
new file mode 100644
index 0000000..91cf88a
--- /dev/null
+++ b/boot/common-framework/src/main/java/com/klaro/acquirecore/framework/TxStatus.java
@@ -0,0 +1,12 @@
+package com.klaro.acquirecore.framework;
+
+/**
+ * Transaction lifecycle states mirroring C tx_status enum.
+ */
+public enum TxStatus {
+    INITIAL,
+    ACTIVE,
+    COMMITTED,
+    ROLLED_BACK,
+    FAILED
+}