Tulindo
All help articles

Help / Payments

Record a settlement

Key in a provider's remittance exactly as its statement shows it, line by line, so the clearing balance it discharges comes down.

What this page is for

This page records one remittance from a provider into your bank — the whole amount, the fees kept back, and one statement line per transaction it paid out — exactly as the provider's own statement shows it. Saving it does not move anything in your accounts by itself; see Settlement for posting it once everything matches.

Only people whose role can manage payments see this page.

Before you start

  • The provider connection this remittance came from must exist. See Connect a provider.
  • Have the provider's settlement statement to hand, with its own reference, the gross figure, the fees it kept, and each transaction it paid out.

Fields

Connection

Which provider connection remitted this money. Required.

Example: the M-Pesa paybill connection.

Settled

The date and time the provider states for the remittance.

Example: 1 October 2026, 09:00.

Provider's reference

The provider's own identifier for this remittance, if its statement gives one. Optional.

Example: the settlement reference on Safaricom's statement.

Gross

The whole remittance, exactly as the provider's statement states it, before fees.

Example: KES 148,500.00.

Fees kept

What the provider deducted before paying out.

Example: KES 2,970.00.

Disputed

Any part of this remittance the provider is disputing. Leave it empty where nothing is disputed.

Example: leave empty; or KES 1,200.00 where one transaction is under query.

Why it is disputed

Required only where Disputed carries an amount.

Example: Chargeback under investigation — ref CB-4471.

Net received

What actually reached the bank. Must equal the gross matched, less fees and anything disputed, plus anything not yet matched; the page will not let the figures disagree.

Example: KES 145,530.00.

Reference

On each statement line: the M-Pesa receipt number or the provider's own reference for that one transaction.

Example: SJA7K2M9QP.

Fee

On each statement line: what the provider deducted for that one transaction.

Example: KES 29.70.

How to…

How to record a settlement

  1. On Payments → Settlements, press Record a settlement.
  2. Choose the Connection, and set Settled to the date and time on the statement.
  3. Fill in Gross, Fees kept, Disputed (if anything is) and Net received.
  4. Press Add line for each transaction on the statement, filling in its Reference, Gross and Fee.
  5. Press Record settlement.

Worked examples

Supermarket

Tumaini Supermarket's accountant records Safaricom's daily M-Pesa settlement. Connection M-Pesa paybill, Settled 1 October 2026, 09:00, Gross KES 148,500.00, Fees kept KES 2,970.00, Net received KES 145,530.00, with one line per M-Pesa receipt number Safaricom's statement lists, each carrying its own fee.

Restaurant and bar

The Acacia Grill & Bar's card acquirer settles every three days with one disputed slip. Gross KES 62,000.00, Fees kept KES 1,240.00, Disputed KES 1,200.00 with reason Chargeback under investigation — ref CB-4471, Net received KES 59,560.00.