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

# Overview

> Welcome! ClickPesa offers a robust and flexible integration suite that supports different business requirements. Whether you need full API control, a simple hosted checkout, or an embedded solution, these guidelines will help you get started

## Integration Options

<CardGroup cols={2}>
  <Card title="Merchant Dashboard" icon="window-maximize" href="/dashboard/dashboard-overview">
    Manage collections, payouts, transactions, and settings from the web
    dashboard — no coding required.
  </Card>

  <Card title="API Integration Setup" icon="code" href="/application/api-application-setup">
    For businesses that require full control over their payment flow, ClickPesa
    provides API-based integration. This setup allows developers to connect
    directly to ClickPesa’s payment infrastructure using secure API endpoints.
  </Card>

  <Card title="Hosted Integration Setup" icon="globe" href="/application/hosted-application-setup">
    If you prefer a simpler approach, ClickPesa provides a hosted payment
    solution. This method allows businesses to redirect users to a
    ClickPesa-hosted page to complete transactions.
  </Card>

  <Card title="Embedded Integration Setup" icon="window-restore" href="/application/embedded-application-setup">
    For businesses that want to maintain a seamless user experience within their
    own platform, ClickPesa provides embedded integration options.
  </Card>
</CardGroup>

## TanQR/Lipa Namba vs BillPay

ClickPesa offers two collection tools for receiving payments without building a custom checkout:

|                            | **TanQR/Lipa Namba**                                             | **BillPay**                                                                                    |
| -------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **What the customer uses** | Your QR code or Lipa Namba                                       | A BillPay control number                                                                       |
| **How they pay**           | Scan QR, or pay via USSD and bank channels using your Lipa Namba | Pay via mobile money USSD, SIM banking, or bank channels using the control number              |
| **Best for**               | Store collections — physical and online                          | Deposits, order payments, invoices, and customer-specific references                           |
| **Setup**                  | [Merchant Dashboard](/tan-qr/lipa-namba-setup)                   | [Merchant Dashboard](/bill-pay/billpay-namba) or [BillPay API](/bill-pay/billpay-api-overview) |

* Use **[TanQR/Lipa Namba](/tan-qr/tan-qr-overview)** when you want customers to scan your QR code or pay using your Lipa Namba.
* Use **[BillPay](/bill-pay/bill-pay-overview)** when you need control numbers for deposits, orders, invoices, or recurring customer payments.

## Additional Features & Considerations

<CardGroup cols={2}>
  <Card title="Payment Statuses" icon="circle-info" href="/home/payment-status">
    Understanding different payment statuses is crucial for managing transactions
    effectively.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/home/webhooks">
    Webhooks allow you to receive real-time payment updates directly to your
    system. Make sure to configure and secure webhook endpoints properly to ensure
    seamless transaction tracking.
  </Card>

  <Card title="IP Whitelisting" icon="lock" href="/home/whitelisted-ip-address">
    Restrict API access to only approved IP addresses for enhanced security. Any
    API request from an unlisted IP will be denied.
  </Card>

  <Card title="Checksum Security" icon="lock" href="/home/checksum">
    For enhanced security, ClickPesa provides checksum validation to verify the
    integrity of transaction data. It is recommended to implement checksum
    verification in all API-based interactions.
  </Card>
</CardGroup>

## Resources

<CardGroup cols={1}>
  <Card title="API Explorer" icon="compass" href="/api-reference">
    Explore and test ClickPesa's APIs with the API Explorer. It provides a
    user-friendly interface to interact with API endpoints and understand their
    functionality.
  </Card>
</CardGroup>
