Integration Options
Merchant Dashboard
Manage collections, payouts, transactions, and settings from the web
dashboard — no coding required.
API Integration 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.
Hosted Integration 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.
Embedded Integration Setup
For businesses that want to maintain a seamless user experience within their
own platform, ClickPesa provides embedded integration options.
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 | Merchant Dashboard or BillPay API |
- Use TanQR/Lipa Namba when you want customers to scan your QR code or pay using your Lipa Namba.
- Use BillPay when you need control numbers for deposits, orders, invoices, or recurring customer payments.
Additional Features & Considerations
Payment Statuses
Understanding different payment statuses is crucial for managing transactions
effectively.
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.
IP Whitelisting
Restrict API access to only approved IP addresses for enhanced security. Any
API request from an unlisted IP will be denied.
Checksum Security
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.
Resources
API Explorer
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.