README

PHP 的 PTT Akıllı Esnaf API 封装

PTT Akıllı Esnaf API 的非官方 PHP 封装

我们从示例代码中获得了很多帮助。

仅涵盖 threeDSecure（联合支付页面）和 inquiry（支付查询）

threeDPayment（3D 支付），void（取消），refund（退款）或 history（交易列表）目前不是我们的目标。我们很高兴看到您的贡献！

依赖项

• PHP 5.6.36 或更高版本
• ext-curl
• ext-json

安装

您可以通过Composer进行安装。

composer require dipnot/ptt-akilliesnaf-php

用法

您可以在examples文件夹中查看完整的示例。

配置

所有请求都需要配置。

use Dipnot\PttAkilliEsnaf\Config;

$config = new Config(true); // Don't forget to change it to "false" in production :)
$config->setClientId("1000000032");
$config->setApiUser("Entegrasyon_01");
$config->setApiPass("gkk4l2*TY112");

发起一个 threeDPayment 请求

use Dipnot\PttAkilliEsnaf\Enum\Currency;
use Dipnot\PttAkilliEsnaf\Request\ThreeDPaymentRequest;

// $config = ...;

$orderId = "ORDERCODE" . time();

$threeDPaymentRequest = new ThreeDPaymentRequest($config);
$threeDPaymentRequest->setCallbackUrl("https:///ptt-akilliesnaf-php/examples/callback.php");
$threeDPaymentRequest->setOrderId($orderId);
$threeDPaymentRequest->setAmount(1000);
$threeDPaymentRequest->setCurrency(Currency::TL);
$threeDPaymentRequest->setInstallmentCount(1);

try {
    $request = $threeDPaymentRequest->execute();
    
    ?>
    <h1>Response:</h1>
    <?php
    echo "<pre>";
    print_r($request->getResponse());
    echo "</pre>";
    ?>

    <hr />

    <h1>Payment iframe:</h1>
    <iframe src="<?= $request->getIframeUrl() ?>" width="1010" height="480"></iframe>
    <?php
} catch(Exception $e) {
    echo $e->getMessage();
}

发起一个 inquiry 请求

use Dipnot\PttAkilliEsnaf\Request\InquiryRequest;

// $config = ...;

$orderId = "SAMPLEORDERCODE";

$inquiryRequest = new InquiryRequest($config);
$inquiryRequest->setOrderId($orderId);

try {
    $request = $inquiryRequest->execute();
    ?>

    <h1>Response:</h1>
    <?php
    echo "<pre>";
    print_r($request->getResponse());
    echo "</pre>";
} catch(Exception $e) {
    echo $e->getMessage();
}

测试卡

在开发此包时，官方文档中的测试卡无法正常工作。因此，我们联系了相关部门，并获得了以下测试值。

许可协议