Batch Payment Processing
Payment Batches let staff group offline transactions — checks, cash, pledges — into a single batch for controlled data entry, balancing, and deposit. Batches enforce a workflow that ensures the number and amounts entered match what was physically received before transactions are finalized.
Batch Workflow
A Payment Batch moves through a defined lifecycle:
CREATED → OPENED → CLOSED
↘ CANCELLED
| Status | Description |
|---|---|
| Created | Batch is set up with metadata and batch type; transactions can be imported |
| Opened | Batch is being processed; corrected totals are set and transactions entered |
| Closed | Batch balances and all transactions are finalized (marked Active) |
| Cancelled | Batch is voided; all transactions are deleted |
| Automated | Batch was created by an automated process |
Creating a Batch
- Navigate to Transactions → Payment Batches and click Create
- Select a Batch Type — this determines which transaction types and payment methods are valid for the batch
- Enter batch metadata:
| Field | Description |
|---|---|
| Received From | Contact who submitted the batch (e.g., a company coordinator) |
| Date Received | When the physical batch was received |
| Description | Free-text description of the batch contents |
| Campaign | Optional campaign association |
| Year | Fiscal or calendar year reference |
- Save — the batch is created in Created status with an auto-generated Instance ID
Batch Lines
Each batch has one or more Batch Lines determined by the Batch Type. Lines represent categories of transactions within the batch — for example, “Credit Card Donations” and “Check Pledges” might be separate lines.
Each line tracks three sets of totals:
| Total Set | Description |
|---|---|
| Recorded | The totals written on the batch cover sheet (what was expected) |
| Corrected | Adjusted totals after review (initialized from Recorded when batch is opened) |
| Entered | Totals calculated from actual transactions entered into the batch |
The batch can only be closed when Corrected = Entered for both pledge and payment amounts.
Opening a Batch
Click Open to move the batch to processing. This:
- Copies Recorded totals to Corrected totals for each line
- Records who opened the batch and when
- Enables transaction entry
Entering Transactions
With the batch open, import or manually create transactions:
- Import — use the Import button to bulk-import transactions from a spreadsheet
- Manual entry — create individual transactions from the Purchase Orders tab
Each transaction is automatically associated with the batch and its amounts contribute to the Entered totals.
Assigning a Batch
The user who opened the batch can Assign it to another user for data entry. Assignment resets Corrected values to Recorded values, giving the assignee a fresh starting point.
Preparing a Deposit
For batches containing received payments, click Prepare Deposit to create a deposit transaction that represents the bank deposit. The deposit amount must match the batch’s bankable amount for the batch to close.
Closing a Batch
Click Close to finalize. The system validates:
- Pledge balance — corrected pledge amount equals entered pledge amount
- Payment balance — corrected payment amount equals entered payment amount
- Bankable balance — if a deposit exists, its amount matches the bankable total
On successful close:
- All transactions in the batch are set to Active status
- The order received date is set from the deposit or batch received date
- The batch is locked from further editing
Cancelling a Batch
Click Cancel to void the batch. All transactions in the batch are marked as Deleted and removed from the batch.
! Cancellation is irreversible. Deleted transactions cannot be recovered from a cancelled batch.
Batch Types
Batch Types are master data records that define the structure of a batch. Each Batch Type specifies:
- Valid Transaction Types — which transaction types can appear in the batch
- Line Types — the categories of transactions tracked separately within the batch
Line Types further specify:
- Campaign Type — optional filter by campaign type
- Payment Methods — which payment methods are valid for that line
Permissions
| Permission | Controls |
|---|---|
| PaymentBatch:Open | Opening a batch for processing |
| PaymentBatch:Close | Closing a balanced batch |
| PaymentBatch:Cancel | Cancelling a batch |
| PaymentBatch:Deposit | Creating deposit transactions |
| PurchaseOrder:import | Importing transactions into a batch |