Millikart onlayn ödəmə sisteminin veb saytınıza və ya tətbiqinizə necə inteqrasiya olunacağını addım-addım izahı. Prosesin hər addımında, lazım olan kod nümunələri və onların funksiyaları ilə bağlı izahlar veriləcəkdir.
Addım 1: API əsaslı inteqrasiyanın həyata keçirilməsi
İlk addım, Millikartın API-lərindən istifadə edərək ödəmə prosesini başlamaqdır. Bu adımda, ödəniş məbləğini, valyutanı, sifariş nömrəsini və digər məlumatları API sorğusu vasitəsilə göndərirsiniz.
Kod nümunəsi:
import requests
# Millikart API URL
api_url = "https://millikart.az/payment/api"
# Müştəri və ödəniş məlumatları
payment_data = {
"amount": 100, # Ödəniş məbləği (məsələn, 100 AZN)
"currency": "AZN", # Valyuta (AZN olaraq seçilmişdir)
"order_id": "123456", # Sifariş nömrəsi (təsadüfi və ya unikal olmalıdır)
"description": "Onlayn alış-veriş", # Ödəniş təsviri (məsələn, məhsul və ya xidmət adı)
"callback_url": "https://sizinvebsayt.az/callback" # Ödəniş sonrası yönləndirmə URL-i
}
# API sorğusunu həyata keçirmək
response = requests.post(api_url, json=payment_data)
# API cavabının emal olunması
if response.status_code == 200:
payment_response = response.json()
# Ödəniş üçün yönləndirmə URL-i
redirect_url = payment_response.get("redirect_url")
print(f"Ödənişi tamamlamaq üçün yönləndirin: {redirect_url}")
else:
print("API sorğusu zamanı xəta baş verdi:", response.status_code)
Açıqlama:
Bu kod parçası, Millikart API-lərinə müştəri və ödəniş məlumatlarını göndərmək üçün istifadə olunur. Sorğu uğurla həyata keçirildikdə, API cavabı olaraq müştərini yönləndirəcəyiniz URL qaytarılır. Müvafiq URL müştərini ödəmə səhifəsinə yönləndirir.
Addım 2: Ödəniş formasının yaradılması
Veb saytınızda müştərilərin ödəmə etməsi üçün bir forma yaratmaq lazımdır. Bu forma vasitəsilə müştəri məlumatları Millikart API-lərinə göndəriləcək.
Kod nümunəsi:
<form action="https://millikart.az/payment/api" method="post">
<input type="hidden" name="amount" value="100">
<input type="hidden" name="currency" value="AZN">
<input type="hidden" name="order_id" value="123456">
<input type="hidden" name="description" value="Onlayn alış-veriş">
<input type="hidden" name="callback_url" value="https://sizinvebsayt.az/callback">
<button type="submit">Ödəniş et</button>
</form>
Açıqlama:
Bu HTML forması, müştərilərinizin veb saytınızdan ödəmə məlumatlarını Millikart API-lərinə göndərməsi üçün istifadə olunur. “hidden” inputlar vasitəsilə ödəniş məbləği, valyuta və sifariş nömrəsi kimi məlumatlar formaya daxil edilir.
Addım 3: Callback URL-də ödənişin təsdiqlənməsi
Müştəri ödənişi tamamladıqdan sonra, ödəmənin nəticəsi Millikart tərəfindən sizin müəyyən etdiyiniz callback URL-ə göndərilir. Bu URL-də ödənişin nəticələrini qəbul edib müştərini müvafiq səhifəyə yönləndirə bilərsiniz.
Kod nümunəsi:
<?php
// Millikart-dan gələn məlumatları qəbul edin
if ($_SERVER["REQUEST_METHOD"] == "POST") {
// Sifariş nömrəsini və ödəniş statusunu alın
$order_id = $_POST["order_id"];
$status = $_POST["status"];
if ($status == "success") {
// Ödəniş uğurla tamamlandı, müştəriyə təsdiq mesajı göstərin
echo "Ödəniş uğurla tamamlandı. Sifariş nömrəsi: " . $order_id;
} else {
// Ödəniş uğursuz oldu, müştəriyə xəbərdar edin
echo "Ödəniş zamanı xəta baş verdi. Zəhmət olmasa yenidən cəhd edin.";
}
}
?>
Açıqlama:
Bu PHP skripti, Millikartın göndərdiyi ödəniş məlumatlarını qəbul edir. Əgər ödəniş uğurlu olarsa, müştəriyə təsdiq mesajı göstərilir. Əks halda, müştəriyə ödənişin uğursuz olduğu və yenidən cəhd etməsi haqqında məlumat verilir.
AzəriCard Onlayn Ödəmə Sisteminin İntegrasiyası:
import requests
api_url = "https://azercard.az/payment/api"
payment_data = {
"amount": 150,
"currency": "AZN",
"order_id": "654321",
"description": "Xidmət haqqı",
"callback_url": "https://sizinvebsayt.az/callback"
}
response = requests.post(api_url, json=payment_data)
if response.status_code == 200:
payment_response = response.json()
redirect_url = payment_response.get("redirect_url")
print(f"Ödənişi tamamlamaq üçün yönləndirin: {redirect_url}")
else:
print("API sorğusu zamanı xəta baş verdi:", response.status_code)
<form action="https://azercard.az/payment/api" method="post">
<input type="hidden" name="amount" value="150">
<input type="hidden" name="currency" value="AZN">
<input type="hidden" name="order_id" value="654321">
<input type="hidden" name="description" value="Xidmət haqqı">
<input type="hidden" name="callback_url" value="https://sizinvebsayt.az/callback">
<button type="submit">Ödəniş et</button>
</form>
<?php
if ($_SERVER["REQUEST_METHOD"] == "POST") {
$order_id = $_POST["order_id"];
$status = $_POST["status"];
if ($status == "success") {
echo "Ödəniş uğurla tamamlandı. Sifariş nömrəsi: " . $order_id;
} else {
echo "Ödəniş zamanı xəta baş verdi. Zəhmət olmasa yenidən cəhd edin.";
}
}
?>
Verilən nümunələr, inteqrasiya prosesinin necə həyata keçiriləcəyini və mümkün olan problemlərin necə həll olunacağını göstərir. Ödəniş sisteminin uğurla qurulması üçün bu addımları izləyərək, müştərilərin ödəmə prosesini rahat və təhlükəsiz şəkildə tamamlamalarını təmin edə bilərsiniz.
