Skip to main content
{
    "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 (inflow) or a debit (outflow).
Every transaction adjusts the balance of an account and provides a full audit trail of how money moves within Monime.

​
Use Cases

  • Customer Payment Recording
    A user pays SLE 500 into your platform via Mobile Money.
    Result: A credit transaction is posted to a financial account of the space; this transaction is linked to a Payment created from the originating Payment Code.
  • Fee Deduction
    A SLE 50 fee is charged for a payout of SLE 1,000.
    Result:
    • A debit transaction of SLE 1,000 from the payout account.
    • A debit transaction of SLE 50 from the payout account.
  • Internal Transfer
    Moving SLE 10,000 from a Settlement Account to a Disbursement Float.
    Result:
    • A debit transaction on the Settlement Account.
    • A credit transaction on the Disbursement Float Account.
  • Refund or Reversal
    If a payment is refunded, a corresponding debit transaction reduces the merchant’s balance.
    Result: The audit trail shows both the original credit and the refund debit, linked together.     
{
    "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.
⌘I