transaction statuses
Every transaction record in Ledgerise carries two independent status fields. Understanding what each one means — and how they interact — tells you exactly where a transaction is in the system and what, if anything, you need to do about it.
two types of status
Transaction status reflects what happened to the transaction in the source system — your payment engine or provider. Ledgerise receives this status from the source; it does not set it.
Posting status reflects what Ledgerise has done with the transaction from the perspective of journal generation and accounting system delivery. Ledgerise sets this value as the transaction moves through the engine.
These two statuses are independent. A completed transaction (the payment settled) may be unposted (the engine has not run yet), posted (the entry is in your books), or unmapped (the engine ran but could not find a matching rule). Read both together to understand the full picture.
transaction status
pending
The transaction has not yet finalised in the source system. May still complete or fail.
No. Only completed transactions are eligible for posting.
completed
The transaction settled successfully. This is the normal end state for a payment.
Yes — this is the trigger for journal posting.
failed
The transaction did not complete. The payment was never processed.
No. Failed transactions are stored for the audit trail but never posted.
reversed
A previously completed transaction has been reversed. The payment was unwound.
Yes — a mirror journal entry is generated if the original was already posted (see below).
disputed
The transaction is under dispute resolution. Posting is held until the dispute is resolved.
Held. Not posted until the dispute status changes.
what happens when a completed transaction is reversed
If a transaction that has already been posted (posting_status: posted) later arrives with status reversed, Ledgerise generates a reversal journal entry — the same accounts and amounts as the original, but with debits and credits swapped, dated to the reversal timestamp.
If the original was not yet posted when the reversal arrived, no journal entry is created. The transaction's status is updated to reversed and the journal engine will not pick it up — only completed transactions are eligible for posting.
posting status
unposted
Grey
Waiting for the next engine run. No journal entry exists yet.
Nothing. The engine will pick it up on the next scheduled run, or you can trigger a run manually from Journal Log.
generated
Grey
Journal entry has been created and is about to be submitted. Brief transient state — you would only see this during an active engine run.
Nothing. This transitions to posting and then posted within the same run.
posting
Grey
Submission to the accounting system is in progress. Brief transient state.
Nothing.
posted
Green
A journal entry was created and successfully submitted to your accounting system.
Nothing. This is the successful end state.
unmapped
Amber
The engine ran but could not find a matching mapping rule for this transaction's product line and biller. The transaction was posted to the suspense account.
Create a mapping rule for this product line and biller, then the engine will re-evaluate on the next run. → unmapped transactions
failed
Red
The engine generated a journal entry and submitted it, but the accounting system returned an error. Ledgerise is retrying automatically.
Check the error in the detail drawer → posting history. Fix the root cause (e.g., an invalid account code) then retry manually if needed. → retrying failed entries
retry_exhausted
Red
The posting was attempted five times and failed each time. Automatic retries have stopped.
Open the detail drawer, read the error, fix the root cause, and click Retry manually. The entry will not re-enter the automatic retry queue.
retry schedule for failed postings
When a posting fails, Ledgerise retries automatically with increasing wait times:
1st retry
5 minutes
2nd retry
15 minutes
3rd retry
1 hour
4th retry
4 hours
5th retry
24 hours
After the fifth failed attempt, the status moves to retry_exhausted and automatic retries stop. The entry remains in the Journal Log and requires manual action.
reading the combination
Here is how to interpret the two statuses together for the most common combinations:
completed
unposted
Transaction settled, waiting for the engine to run
completed
posted
Transaction settled and journal entry is in the accounting system — done
completed
unmapped
Transaction settled but no mapping rule matched — suspense account hold, action needed
completed
failed
Transaction settled, entry generated, accounting system rejected it — fix and retry
completed
retry_exhausted
Transaction settled, all retries failed — manual intervention required
failed
unposted
Payment failed in source system — stored for audit trail, will never be posted
reversed
posted
Reversal triggered a mirror journal entry — both the original and the reversal are in the books
reversed
unposted
Transaction reversed before a journal entry was ever created — the engine will not pick it up, since only completed transactions are eligible
pending
unposted
Payment not yet settled — waiting for the source system to finalise it
filtering by status
From the Transactions page, use the filter bar to show only records with a specific posting status. Common filters:
Unmapped only — shows all transactions in the suspense account that need a mapping rule.
Failed only — shows all transactions where posting was attempted but the accounting system returned an error.
Retry exhausted — shows records that need manual retry.
Unposted — shows transactions queued for the next engine run.
You can combine posting status filters with date range, product line, or adapter filters.
Last updated
