Payments Troubleshooting
For: Office Staff, Administrators
Quick Reference Guide
This page provides quick solutions to common payment-related errors and issues. For detailed instructions, see the linked documentation.
Cannot Record Payment Issues
"Cannot record payment on this order"
Symptoms:
Record Payment button disabled
Error message when trying to record payment
Form won't open
Check:
✓ Is order status Delivered? (Only delivered orders can receive payments)
✓ Is invoice cancelled? (Cannot pay cancelled invoices)
✓ Do you have permission to record payments?
✓ Is customer account active?
Solutions:
Mark order as Delivered first:
Navigate to order
Change status from Confirmed/Fulfilled to Delivered
Then record payment
Check user permissions:
Contact administrator
May need "Record Payments" permission
Check role assignments
Verify invoice not cancelled:
Check invoice status
Cannot pay cancelled invoices
Create new invoice if needed
"Payment amount exceeds balance due"
Symptoms:
Error when entering payment amount
Cannot save payment
Validation message about amount
Check:
✓ What is the current invoice balance due?
✓ Were other payments already applied?
✓ Was a credit already applied?
✓ Did you enter decimal point correctly? ($100.00 not $10000)
Solutions:
Verify current balance:
Check invoice detail page
Look for "Balance Due" or "Amount Outstanding"
Payment amount cannot exceed this
Check for existing payments:
Review transaction history
Payment may have already been recorded
Partial payment may have been applied
Check for applied credits:
Customer may have credits applied
See: Credits on Invoices
Handle overpayment:
If customer legitimately overpaid:
Apply partial amount to invoice
Create credit for excess
Or apply to other unpaid invoices
See: Recording Individual Payments
"Duplicate check number detected"
Symptoms:
Warning message about check number
Cannot save payment
"Check number already used" error
Check:
✓ Was this check already entered?
✓ Is customer using same check for multiple invoices?
✓ Did you transpose digits in check number?
✓ Is this a different check with same number? (rare)
Solutions:
Search for existing payment:
Use payment search/filter
Filter by check number
May have already been recorded
Use Bulk Payment Entry:
If one check pays multiple invoices
Don't record individually
See: Bulk Payment Entry
Verify check number:
Check the physical check
Confirm number typed correctly
Common errors: 4821 vs 4812
Legitimate duplicate:
Rare but possible (customer reuses numbers)
Add note explaining situation
May need supervisor override
See: Bulk Payment Entry for Multiple Invoices
Payment Display Issues
Payment not showing on invoice
Symptoms:
Recorded payment but not visible
Transaction history empty
Balance didn't change
Check:
✓ Did you see a save confirmation message?
✓ Try refreshing the page
✓ Check transaction history section
✓ Are you looking at correct invoice?
Solutions:
Refresh the page:
Browser may be showing cached version
Press Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)
Or click refresh button
Check transaction history:
Scroll down to Transaction History section
Payment should be listed there
If not present, payment didn't save
Payment didn't save:
Look for error messages
Check browser console for errors
Re-enter payment
Wrong invoice:
Verify invoice number
May have recorded on different invoice
Search by check number to find it
Payment shows in Masava but not QuickBooks
Symptoms:
Payment recorded in Masava
Not appearing in QuickBooks
Customer statements don't match
Check:
✓ Is QuickBooks integration active?
✓ Is invoice status Delivered? (QB only syncs delivered orders)
✓ How long has it been? (Sync can take 5-15 minutes)
✓ Check integration push log for errors
Solutions:
Wait for sync:
Normal sync time: 5-15 minutes
Check back in a bit
Don't record payment twice
Verify invoice was delivered:
QB only syncs Delivered orders
If Confirmed/Fulfilled, mark as Delivered first
Payment will then sync
Check integration status:
Settings → Integrations → QuickBooks
Verify connection active
Check for error messages
Review integration push log:
May show sync errors
Common issues: QB credential expired, field mapping errors
Manual sync (if available):
Some systems have "Sync Now" button
Forces immediate sync
Check with administrator
See: QuickBooks: Understanding the Sync Process
Bulk Payment Issues
"Total allocated doesn't match payment amount"
Symptoms:
Cannot save bulk payment
Error message about mismatch
Running total doesn't equal payment amount
Check:
✓ Sum of allocated amounts
✓ Total payment amount entered
✓ Any rounding errors (pennies)?
Solutions:
Recalculate manually:
Use calculator to sum allocations
Compare to total payment amount
Find the discrepancy
Adjust allocation amounts:
If over-allocated: Reduce one or more amounts
If under-allocated: Increase or add more
Common: Adjust largest invoice by difference
Use "Auto-Allocate":
Click Auto-Allocate button
System will redistribute
Then adjust as needed
Verify payment amount correct:
Check physical check
Confirm amount entered correctly
Watch for decimal point errors
Example Fix:
See: Bulk Payment Entry - Step 6: Verify Totals Match
Cannot select invoices from different customers
Symptoms:
Checkboxes disabled for some invoices
Error when selecting multiple customers
"Must be same customer" message
Why:
Bulk payment is for one customer only
One check = one customer account
System enforces this rule
Solution:
Record separate bulk payments for each customer
Or use individual payment entry for different customers
Workflow:
Filter by Customer A
Select Customer A invoices
Record bulk payment for Customer A
Then switch to Customer B
Repeat for Customer B
See: Bulk Payment Entry - Prerequisites
Invoice not appearing in list
Symptoms:
Customer's invoice not showing
Expected invoice missing from filter results
Cannot select invoice for bulk payment
Check:
✓ Is invoice status Delivered? (Only delivered invoices can be paid)
✓ Is invoice already paid? (Filter may be hiding paid invoices)
✓ Is invoice for correct customer? (Check spelling/account name)
✓ Is invoice cancelled? (Cannot pay cancelled invoices)
✓ Are filters too restrictive? (Date range, etc.)
Solutions:
Adjust status filter:
Show "All statuses"
Look for invoice in list
Check its actual status
Search by invoice number:
Use invoice number search
Bypass filters
Verify invoice exists
Verify customer match:
Check invoice customer name
May be under different account
Check for typos
Mark as Delivered:
If status is Confirmed/Fulfilled
Mark as Delivered first
Then will appear in payment list
Allocation grid not saving
Symptoms:
Click Save but nothing happens
Spinner keeps spinning
No confirmation message
Check:
✓ Do totals match exactly?
✓ Are there validation errors shown (red text)?
✓ Is any field blank or invalid?
✓ Check browser console for JavaScript errors
Solutions:
Fix validation errors:
Look for red text/error messages
Fix any invalid fields
Ensure all required fields filled
Check totals match:
Most common issue
Verify allocated total = payment amount
Adjust if needed
Refresh and retry:
Save your allocation notes
Refresh the page
Re-enter payment
May be temporary system issue
Try different browser:
Browser cache issue
Try Chrome, Firefox, or Edge
Clear browser cache
Contact support:
If problem persists
Provide invoice numbers
Screenshot of error helpful
Check number already used warning
Symptoms:
System warns check number exists
Cannot save with this check number
"Duplicate detected" error
Possible Causes:
Already entered this payment
Bulk payment needed (same check, multiple invoices)
Typo in check number
Customer reused check number (rare)
Solutions:
Search for existing payment:
Filter by check number
See if already recorded
Check who recorded it and when
Use Bulk Payment Entry:
If same check pays multiple invoices
That's what bulk payment is for!
See: Bulk Payment Entry
Verify check number:
Check physical check
Confirm typed correctly
Common: 4821 vs 4812, 4281, etc.
Legitimate duplicate:
Very rare
Add note explaining
May need supervisor approval
Payment Reversal Issues
Cannot delete payment
Symptoms:
Delete button disabled/grayed out
"Permission denied" error
Cannot access delete option
Check:
✓ Do you have permission to delete payments?
✓ Is payment synced to QuickBooks and locked?
✓ Is accounting period closed?
✓ Is payment part of closed transaction?
Solutions:
Permission issue:
Contact system administrator
Request "Delete Payments" permission
May be restricted to certain roles
QuickBooks locked:
Ask accounting team
May need to unlock period
Explain reason for reversal
Period closed:
Accounting period may be closed
Need accountant to manually adjust in QuickBooks
Document reversal request
Work with accounting:
Don't circumvent financial controls
Follow proper approval process
Document reason for reversal
See: Handling NSF Checks & Payment Reversals
Payment reversal not syncing to QuickBooks
Symptoms:
Reversed payment in Masava
Still showing in QuickBooks
Customer account balance doesn't match
Check:
✓ Is QuickBooks integration active?
✓ Check integration push log for errors
✓ How long has it been? (Can take up to 15 minutes)
✓ Is QB period locked/closed?
Solutions:
Wait longer:
Sync can take 10-15 minutes
Don't reverse again
Check back shortly
Check integration status:
Verify QB connection active
Check for error messages
Test connection
Review integration push log:
Look for sync errors
Common: Credentials expired, locked period
Note error code/message
Manual QB adjustment:
If period locked
Accountant must manually reverse in QB
Provide reversal documentation
See: QuickBooks: Troubleshooting Sync Issues
Check Number Issues
Missing check numbers in reports
Symptoms:
Payment reports show blank check numbers
Cannot reconcile with bank deposits
Missing data in exports
Check:
✓ Were check numbers entered when recording payment?
✓ Check for typos or spaces in check numbers
✓ Field labeled correctly (Check # vs Reference #)
Solutions:
Edit payment details:
Open invoice with payment
Edit payment (if allowed)
Add missing check number
Save
Add to notes:
If cannot edit payment amount/method
Add check number in notes field
Better than nothing for reconciliation
Train staff:
Emphasize importance of check numbers
Make field required (if possible)
Check data entry regularly
Data cleanup:
Export payments without check numbers
Research original checks
Update in batches
Prevention: ✅ Always enter check numbers when recording payments ✅ Make it a required field ✅ Double-check before saving
Check numbers not exporting correctly
Symptoms:
Check numbers cut off in export
Leading zeros missing (00123 becomes 123)
Numbers formatted as dates
Check:
✓ Export format (CSV, Excel, etc.)
✓ Excel auto-formatting issue
✓ Check number length/format
Solutions:
Excel formatting:
Check numbers may be formatted as numbers, not text
Format column as "Text" before importing
Or use single quote: '00123
Export as CSV:
Open in text editor first
Verify data is correct
Then import to Excel with Text format
Leading zeros:
If lost, may need to re-add
Use formula: =TEXT(A1,"00000")
Adjust format to match your check numbers
Payment Method Issues
Wrong payment method selected
Symptoms:
Recorded as Check but was ACH
Reports don't match reality
Bank reconciliation issues
Solutions:
Cannot edit payment method directly:
Must delete and re-record payment
Add clarifying note:
If cannot delete
Add note: "Actually paid via ACH, not check"
Better than nothing for records
Payment method not available
Symptoms:
Expected payment method missing from dropdown
New payment type not listed
Solutions:
Use closest available:
Example: Use "ACH" for wire transfer
Add note clarifying actual method
Request new payment method:
Contact administrator
May need system configuration
Explain business need
Use "Other" with notes:
Last resort
Add detailed notes about payment method
Include in description
System/Technical Issues
Payment entry form won't load
Symptoms:
Blank page
Spinning/loading forever
Form doesn't appear
Solutions:
Refresh the page:
Try reloading
May be temporary glitch
Clear browser cache:
Cached data may be corrupted
Clear cache and cookies
Try again
Try different browser:
Test in Chrome, Firefox, Edge
May be browser-specific issue
Check system status:
Ask if others having same issue
May be system-wide problem
Contact support
Payments page slow/timing out
Symptoms:
Page takes forever to load
Timeout errors
Cannot access payment features
Solutions:
Check filters:
Too broad date range
"All time" can be very slow
Narrow date range
Reduce results:
Filter by customer
Filter by date range
Limit results displayed
Check system load:
May be peak usage time
Try during off-hours
Contact support if persistent
Still Need Help?
If your issue isn't covered here:
Check related documentation:
Check integration docs:
Contact support:
Describe the issue clearly
Include invoice numbers
Provide screenshots if possible
Note any error messages
Quick Links
Payment Guides
Related Topics
Last updated
Was this helpful?