README

Kapital 银行提供的 ECOM 服务的新 TXPG API 库。通过这个库，您可以在网站上通过 KapitalBank 接收支付。

安装

您可以通过 Composer 安装此包。 Composer。

为此，请将以下命令输入到终端

composer require faganchalabizada/kapital-merchant-txpg

使用

创建示例支付页面的示例

use FaganChalabizada\KapitalMerchantTXPG\Merchant;
use FaganChalabizada\KapitalMerchantTXPG\OrderType;
use FaganChalabizada\KapitalMerchantTXPG\Exception\OrderException;

//İstifadə üçün ilk olaraq Merchant classını çağırmaq lazımdır.
$merchant = new Merchant();

try {

//ödəniş sorğusunu yaradırıq 
$create_order = $merchant->createOrder(OrderType::PURCHASE, 1, "AZN", "az", "https://SİZİN_ÖDƏNİŞİ_YOXLAMAQ_ÜÇÜN_OLAN_LİNKİNİZ.COM/checkPayment");

//qaytarılan $order_id dəyişkənini Məlumat Bazasında saxlamaq lazımdır. 
$order_id = $create_order->getId();

//$full_url dəyişkəni isə ödəniş səhifəsinin linkidir. İstifadəçını həmin linkə yönləndirmək lazımdır.
$full_url = $create_order->getFullRedirectUrl();

//yönləndiririk
header('Location: '.$full_url);

} catch (OrderException $e) {
    //burada ödəniş sorğusu yaradılan zaman hər hansı səhv baş verirsə əks olunacaq.
    echo $e->getMessage();
}

支付后检查支付状态的示例

use FaganChalabizada\KapitalMerchantTXPG\Merchant;
use FaganChalabizada\KapitalMerchantTXPG\PaymentStatuses;

$merchant = new Merchant();

$id = intval($_GET['ID']); //order ID

$res = $merchant->getOrderStatus($id);//Ödənişi yoxlayırıq

if ($res->getStatus() == PaymentStatuses::FULLY_PAID) {//Ödəniş uğurludur

    $order_id = $res->getId();//order ID. Məlumat bazasından tapmaq üçün
    $amount = $res->getAmount();//Ödənilən məbləğ təkrar yoxlanış üçün.

    echo "Ödəniş uğurludur.<br/>";
    echo "Order ID: " . $order_id . "<br/>";
    echo "Məbləğ: " . $amount . "<br/>";

} else {

    echo "Ödəniş uğursuzdur.<br/>";
    echo "Order ID: " . $order_id . "<br/>";
    echo "Məbləğ: " . $amount . "<br/>";

    echo "Ətraflı: " . PaymentStatuses::getDescription($res->getStatus());//Ödənişin hal hazırki statusu.
}

在测试此表单后，要进入实时模式，请在 $merchant = new Merchant(); 之后立即添加以下代码

$merchant->setAuth("BANKIN_VERDIYI_USERNAME", "BANKIN_VERDIYI_PASSWORD");

许可证

Kapital 银行 ECOM 商户 TXPG API 是开源软件，根据 MIT 许可证 授权。