Jinsi ya Kutumia API ya ClickPesa Kwenye PHP Website
API Ni Nini?
API (Application Programming Interface) ni mfumo unaowezesha website yako kuwasiliana moja kwa moja na ClickPesa
.
Kwa kutumia API unaweza:
Kutengeneza payment links
Kupokea malipo
Kuangalia status ya malipo
Kutuma payouts
Kupokea payment notifications
Vitu Unavyohitaji Kabla ya Kutumia API
1. Akaunti ya ClickPesa
Fungua akaunti:
ClickPesa Signup
2. API Keys
Kwenye dashboard:
Nenda Settings
Fungua API Keys
Copy:
Public Key
Secret Key
API Token (kama ipo)
⚠️ Secret key usimpe mtu yeyote.
3. PHP Server yenye cURL
Hakikisha PHP yako ina:
cURL enabled
HTTPS support
Hatua ya Kwanza — Kutengeneza Payment Link
create_payment.php
<?php
$apiKey = "YOUR_SECRET_KEY";
$data = [
"amount" => 10000,
"currency" => "TZS",
"reference" => "ORDER_" . time(),
"customer_name" => "Faustine",
"customer_email" => "customer@gmail.com",
"customer_phone" => "255712345678",
"description" => "Malipo ya bidhaa",
"callback_url" => "https://yourwebsite.com/callback.php",
"redirect_url" => "https://yourwebsite.com/success.php"
];
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.clickpesa.com/checkout-link/generate-checkout-url",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Authorization: Bearer $apiKey"
],
CURLOPT_POSTFIELDS => json_encode($data)
]);
$response = curl_exec($curl);
curl_close($curl);
$result = json_decode($response, true);
if(isset($result['checkoutUrl'])){
header("Location: ".$result['checkoutUrl']);
exit;
}else{
echo "<pre>";
print_r($result);
echo "</pre>";
}
?>
API Inafanya Nini Hapa?
Code hii:
✅ Inatuma request kwa ClickPesa
✅ Inatengeneza payment link
✅ Inampeleka customer kwenye ukurasa wa malipo
Hatua ya Pili — Callback URL
Baada ya customer kulipa, ClickPesa itatuma taarifa kwenye callback URL yako.
callback.php
<?php
$data = file_get_contents("php://input");
file_put_contents("payments.txt", $data . PHP_EOL, FILE_APPEND);
echo "Callback Received";
?>
Callback Inasaidia Nini?
Inakusaidia:
Kuhifadhi malipo
Kuupdate database
Kuactivate account
Kuthibitisha payment automatically
Hatua ya Tatu — Success Page
success.php
<!DOCTYPE html>
<html>
<head>
<title>Payment Success</title>
</head>
<body>
<h1>Malipo Yamefanikiwa</h1>
<p>Asante kwa kufanya malipo.</p>
</body>
</html>
Jinsi ya Kuunganisha na MySQL
Unaweza kuhifadhi malipo kwenye database.
SQL Table
CREATE TABLE payments (
id INT AUTO_INCREMENT PRIMARY KEY,
reference_id VARCHAR(200),
customer_name VARCHAR(200),
amount DECIMAL(10,2),
status VARCHAR(50),
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
Faida za Kutumia API ya ClickPesa
✅ Mobile Money zote Tanzania
✅ Automatic payments
✅ Rahisi kuunganisha na PHP
✅ Inafaa kwa school systems
✅ Inafaa kwa e-commerce
✅ Real-time payment notifications
API Unaweza Kutumia Kwa
Mfumo Inawezekana
School Management System ✅
Accounting System ✅
E-commerce Website ✅
Online Courses ✅
Donation Website ✅
Membership Website ✅
Security Muhimu
⚠️ Usionyeshe Secret API Key kwenye:
HTML
JavaScript
GitHub public repo
Tumia server-side PHP pekee.
Hitimisho
Kwa kutumia API ya ClickPesa
unaweza kutengeneza mfumo professional wa:
kupokea malipo,
kutengeneza payment links,
kuthibitisha payments,
na kuunganisha website yako moja kwa moja na Mobile Money Tanzania.
🚀 Unahitaji mfumo au website ya biashara?
Chagua huduma hapa chini kisha mteja bofya moja kwa moja kwenda kwenye ukurasa wa huduma au kuwasiliana nasi kwa WhatsApp.