UploadProofOfPaymentDto

documentIdstringrequired

ID of a Document previously uploaded to /documents. The document must be owned by the caller.

Example: 550e8400-e29b-41d4-a716-446655440000

amountnumberrequired

Amount paid, in the referral currency.

Possible values: >= 1

Example: 250000

currencystring

3-letter currency code. Defaults to UGX.

Possible values: >= 3 characters and <= 3 characters

Example: UGX

insurerReferencestringrequired

Reference the client used at the insurer / bank / mobile-money provider — the string ZFA will forward to the insurer for cross-check.

Possible values: >= 2 characters and <= 100 characters

Example: AAR-PMT-2026-000123

paidAtstringrequired

Date the client made the payment. ISO 8601.

Example: 2026-07-12T09:15:00Z

methodstring

Payment method: bank, mobile_money, cash, etc.

Possible values: <= 40 characters

Example: mobile_money

notesstring

Free-text notes visible to ZFA reviewers.

Possible values: <= 500 characters

Example: Client paid full annual premium in a single instalment.

UploadProofOfPaymentDto

{
  "documentId": "550e8400-e29b-41d4-a716-446655440000",
  "amount": 250000,
  "currency": "UGX",
  "insurerReference": "AAR-PMT-2026-000123",
  "paidAt": "2026-07-12T09:15:00Z",
  "method": "mobile_money",
  "notes": "Client paid full annual premium in a single instalment."
}