Add partial transaction processing support #3

New issue

Open

opened 2026-01-01 16:05:48 +00:00 by padreug · 0 comments

padreug commented

2026-01-01 16:05:48 +00:00

Owner

Feature Request

Problem

When a Lamassu ATM transaction fails mid-dispensing, only a portion of the bills are actually dispensed to the customer. Currently, the manual transaction processing feature processes the entire transaction amount, but in these failure scenarios we need the ability to process only the portion that was actually dispensed.

Proposed Solution

Add the ability to process a partial transaction based on the actual number of bills confirmed as dispensed. The Lamassu transaction data already includes information about which bills were successfully dispensed, making this feasible.

Implementation Ideas

Add a "Process Partial" option alongside the existing "Process Transaction" action
Allow admin to specify or confirm the actual dispensed amount before processing
Use the confirmed dispensed bill count from the transaction data to calculate the partial amount
Record that this was a partial processing in the audit trail

Use Case

Customer initiates a withdrawal for 1000 GTQ (10 bills)
ATM dispenses 6 bills before encountering an error
Transaction shows as failed but with 6 bills confirmed dispensed
Admin can now process only the 600 GTQ portion that was actually received by the customer

Benefits

More accurate commission calculation for partial transactions
Better customer experience - they receive DCA allocation matching what they actually deposited
Improved audit accuracy for failed transaction scenarios

## Feature Request ### Problem When a Lamassu ATM transaction fails mid-dispensing, only a portion of the bills are actually dispensed to the customer. Currently, the manual transaction processing feature processes the entire transaction amount, but in these failure scenarios we need the ability to process only the portion that was actually dispensed. ### Proposed Solution Add the ability to process a partial transaction based on the actual number of bills confirmed as dispensed. The Lamassu transaction data already includes information about which bills were successfully dispensed, making this feasible. ### Implementation Ideas - Add a "Process Partial" option alongside the existing "Process Transaction" action - Allow admin to specify or confirm the actual dispensed amount before processing - Use the confirmed dispensed bill count from the transaction data to calculate the partial amount - Record that this was a partial processing in the audit trail ### Use Case 1. Customer initiates a withdrawal for 1000 GTQ (10 bills) 2. ATM dispenses 6 bills before encountering an error 3. Transaction shows as failed but with 6 bills confirmed dispensed 4. Admin can now process only the 600 GTQ portion that was actually received by the customer ### Benefits - More accurate commission calculation for partial transactions - Better customer experience - they receive DCA allocation matching what they actually deposited - Improved audit accuracy for failed transaction scenarios

No labels

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: aiolabs/satmachineadmin#3

No description provided.

Rows
Columns