Jinsi ya kuunganisha ClickPesa na PHP website

Ndiyo. Njia rahisi zaidi ni kutumia Hosted Checkout Link API: website yako ya PHP inatengeneza link ya malipo, kisha mteja anaelekezwa kulipa kupitia ClickPesa. ClickPesa inasema hosted checkout ni rahisi kwa sababu security na checkout page vinasimamiwa na ClickPesa.

Hatua kwa kifupi
Fungua akaunti ya ClickPesa.
Pata API credentials kwenye dashboard.
Tengeneza page ya PHP inayotuma request kwenda ClickPesa.
ClickPesa ikirudisha checkout link, mredirect mteja kwenye link hiyo.
Baada ya malipo, angalia malipo kwenye Transactions au tumia webhook/callback kuthibitisha payment.

ClickPesa inasaidia kupokea malipo kupitia mobile money, bank transfers na card payments.

Mfano wa PHP wa kutengeneza payment link

Badilisha YOUR_API_KEY na API key yako halisi.

<?php
// create_payment.php

$apiKey = "YOUR_API_KEY";

$data = [
"amount" => 10000,
"currency" => "TZS",
"description" => "Malipo ya ada ya shule",
"reference" => "INV-" . time(),
"customer" => [
"name" => "Juma Mohamed",
"email" => "juma@example.com",
"phone" => "255712345678"
],
"callbackUrl" => "https://yourwebsite.com/callback.php&quot;,
"returnUrl" => "https://yourwebsite.com/success.php&quot;
];

$ch = curl_init("https://api.clickpesa.com/checkout-link/generate-checkout-url&quot;);

curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Authorization: Bearer " . $apiKey
],
CURLOPT_POSTFIELDS => json_encode($data)
]);

$response = curl_exec($ch);

if (curl_errno($ch)) {
die("cURL Error: " . curl_error($ch));
}

curl_close($ch);

$result = json_decode($response, true);

if (isset($result['checkoutUrl'])) {
header("Location: " . $result['checkoutUrl']);
exit;
} else {
echo "<pre>";
print_r($result);
echo "</pre>";
}
?>
Muhimu

Endpoint sahihi na majina ya fields yanaweza kutofautiana kulingana na API credentials zako, hivyo linganisha na documentation ya ClickPesa ya Generate Checkout Link, ambayo ni POST ya kutengeneza link ya kupokea malipo.

Kwa website ya PHP, njia salama ni kuweka API key kwenye server side tu, usiiweke kwenye JavaScript au HTML ya frontend.