Partial Payment

Partial payments allow customers to pay an invoice in multiple installments instead of a single payment. Each installment can be paid separately, and the invoice status tracks the overall payment prog

How Partial Payments Work

1. Invoice Creation: Invoice is created with multiple installments, all in NEW status

2. Payment Initiation: Customer initiates payment for the invoice

3. Installment Selection: System automatically selects installments to pay based on:

   • Payment amount

   • Installment order (sequential)

   • Unpaid installments only

4. Payment Processing: Payment is applied to installments in order until the payment amount is exhausted

5. Status Updates:

   • Individual installment status updated to PAID

   • Invoice status updated to PARTIALLY_PAID or PAID

Payment Scenarios

Scenario 1: Paying First Installment

Invoice: 30,000 RWF
Installments:
  - Installment 1: 10,000 RWF (NEW)
  - Installment 2: 10,000 RWF (NEW)
  - Installment 3: 10,000 RWF (NEW)

Payment: 10,000 RWF

Result:
  - Installment 1: PAID
  - Installment 2: NEW
  - Installment 3: NEW
  - Invoice Status: PARTIALLY_PAID

Scenario 2: Paying Multiple Installments

Invoice: 30,000 RWF
Installments:
  - Installment 1: 10,000 RWF (NEW)
  - Installment 2: 10,000 RWF (NEW)
  - Installment 3: 10,000 RWF (NEW)

Payment: 25,000 RWF

Result:
  - Installment 1: PAID (10,000)
  - Installment 2: PAID (10,000)
  - Installment 3: PARTIALLY_PAID (5,000 paid, 5,000 remaining)
  - Invoice Status: PARTIALLY_PAID

Note: Partial payment of an individual installment is not supported. Payments must cover complete installments in order.

Scenario 3: Completing Payment

Invoice: 30,000 RWF
Installments:
  - Installment 1: 10,000 RWF (PAID)
  - Installment 2: 10,000 RWF (PAID)
  - Installment 3: 10,000 RWF (NEW)

Payment: 10,000 RWF

Result:
  - Installment 1: PAID
  - Installment 2: PAID
  - Installment 3: PAID
  - Invoice Status: PAID