{
    "id": null,
    "type": "credit",
    "amount": {
        "currency": null,
        "value": null
    },
    "timestamp": null,
    "reference": null,
    "financialAccount": {
        "id": null,
        "balance": {
            "after": {
                "currency": null,
                "value": null
            }
        }
    },
    "originatingReversal": {
        "originTxnId": null,
        "originTxnRef": null
    },
    "originatingFee": {
        "code": null
    },
    "ownershipGraph": {
        "owner": {
            "id": null,
            "type": null,
            "metadata": null,
            "": null
        }
    },
    "metadata": null
}
A Financial Transaction represents a movement of funds that affects a financial account either as a credit or a debit. Each transaction includes an amount, a type (credit or debit), and a reference to the financial account it impacts. It may optionally be tied to an originating fee (like a platform charge) and includes a full ownership graph to trace which object or service triggered it such as a payout, internal transfer, or payment code. This makes the transaction both auditable and traceable across business logic layers. Additional metadata and timestamps enable rich querying and system-wide reconciliation. 
{
    "id": null,
    "type": "credit",
    "amount": {
        "currency": null,
        "value": null
    },
    "timestamp": null,
    "reference": null,
    "financialAccount": {
        "id": null,
        "balance": {
            "after": {
                "currency": null,
                "value": null
            }
        }
    },
    "originatingReversal": {
        "originTxnId": null,
        "originTxnRef": null
    },
    "originatingFee": {
        "code": null
    },
    "ownershipGraph": {
        "owner": {
            "id": null,
            "type": null,
            "metadata": null,
            "": null
        }
    },
    "metadata": null
}
​
📋
Properties
​
id
string
Unique identifier for this financial transaction.
​
type
enum<string>
Indicates whether the transaction is a ‘credit’ or ‘debit’.Available options: credit debit
​
amount
object
The monetary value involved in this transaction.
​
timestamp
string
The exact time when this transaction was recorded.
​
reference
string
Internal identifier associated with this transaction for reconciliation purposes.
​
financialAccount
object
The account that was debited or credited as part of this transaction, including post-transaction balance snapshot.
​
originatingReversal
object
Indicates that this transaction was created as the result of a reversal action. The transaction itself represents the reversal of fund.
​
originatingFee
object
Indicates that this transaction was created as the result of an internal platform fee. The transaction itself represents the fee.
​
ownershipGraph
object
Traceability structure showing which resource or object owns or initiated this transaction.
​
metadata
object
Custom structured key-value pairs associated with this transaction for additional context.