> ## Documentation Index
> Fetch the complete documentation index at: https://docs.capedigital.co.ke/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Service

> Invoice requests, invoice uploads, payment tracking, and commission management.

Handles the billing and revenue side of completed campaigns — from invoice request through payment confirmation and sales commission calculation. Owned by `payment-service`.

**Base URL:** `https://api.capedigital.co.ke/payment`

## Key resources

| Resource         | Description                                                                    |
| ---------------- | ------------------------------------------------------------------------------ |
| Invoice Requests | Raised by sales when a campaign is live; triggers finance to upload an invoice |
| Invoices         | Tax invoices uploaded by finance for the full booking amount                   |
| Payments         | Partial or full payment records against an invoice                             |
| Commissions      | Sales executive commission applications and approvals                          |

## Billing flow

```
Campaign RUNNING → Sales raises InvoiceRequest → Finance uploads Invoice
→ Client makes Payment(s) → Invoice marked PAID → Commission calculated
```

The invoice always covers the **full booking grand total**. Partial settlement is handled through multiple `Payment` records against a single invoice.

<Note>
  See the **Payment** tab in the top navigation for the full API reference.
</Note>
