Skip to main content

Overview

Associated payments are transactions that have been successfully linked to customer accounts. When a payment is associated:
  • Customer’s balance is credited
  • Customer can purchase internet plans
  • Revenue is properly attributed

Viewing Associated Payments

  1. Navigate to Payments in the sidebar
  2. The default view shows associated payments
  3. If viewing unassociated, click Regular button to switch back

Payment List

The associated payments table shows:
ColumnDescription
#Row number
CustomerAccount number
CodeTransaction code
PhonePayer’s phone
AmountPayment amount
Date PaidTransaction timestamp
ActionDisassociate button
Associated Payments

Making a Manual Payment

To record a payment manually:
1

Click Make Payment

Click the Make Payment button at the top
2

Select Customer

Choose the customer from the dropdown
3

Enter Amount

Input the payment amount
4

Confirm

Click Submit to record the payment
Manual payments are immediately associated with the selected customer.

Disassociating a Payment

If a payment was associated with the wrong customer:
1

Find the Payment

Locate the payment in the list
2

Click Disassociate

Click the red Disassociate button
3

Confirm

Click Confirm in the dialog
Disassociating removes the payment from the customer’s balance. The payment moves to unassociated payments.

Understanding Payment Codes

Payment codes are unique identifiers:
Format: ABCD1234XYZ
Source: Generated by payment provider (M-PESA, etc.)
Purpose: Reference for support and reconciliation

Phone Number Matching

Payments are auto-associated based on phone numbers:

Searching Payments

Search functionality:
  • Local search first: Checks currently loaded payments
  • Backend search: Queries server for older records
  • Debounced: Waits 300ms after typing
Search fields:
  • Customer Account Number
  • Phone Number
  • Transaction Code
  • Amount

Balance Impact

When payment is associated:
New Balance = Previous Balance + Payment Amount
ActionBalance Effect
Payment associatedBalance increases
Payment disassociatedBalance decreases
Voucher purchasedBalance decreases

Best Practices

Periodically review that payments match the correct customers
Record manual payments immediately to avoid discrepancies
Note the transaction code when handling customer queries

Troubleshooting

IssueCauseSolution
Payment shows wrong customerPhone number used by multiple accountsVerify customer identity
Balance not updatedPage not refreshedRefresh the page
Can’t find paymentToo old, not loadedUse search function

Integration with Other Features

FeatureRelationship
Customer BalancePayments credit the balance
VouchersPurchased using credited balance
Dashboard RevenueAggregates associated payments
TransactionsComplete log includes all payments

Next Steps