README

PayFast PHP SDK 提供了一个易于使用的库，用于将 PayFast 支付集成到您的项目中。这包括自定义集成、本地集成以及所有 API。

要求

PHP 7.2.5 及以上版本。

文档

Composer

您可以通过 Composer 安装此库。运行以下命令

composer require payfastsdk/payfast-php-sdk

要使用此库，请使用 Composer 的自动加载

require_once('vendor/autoload.php');

入门指南

自定义集成

构建一个结账表单，并安全地从 PayFast 支付平台接收支付。

try {
    $payfast = new PayFastPayment(
        [
            'merchantId' => '10000100',
            'merchantKey' => '46f0cd694581a',
            'passPhrase' => '',
            'testMode' => true
        ]
    );

    $data = [
        'amount' => '100.00',
        'item_name' => 'Order#123'
    ];

    echo $payfast->custom->createFormFields($data, ['value' => 'PAY NOW', 'class' => 'btn']);
} catch(Exception $e) {
    echo 'There was an exception: '.$e->getMessage();
}

本地支付

直接将 PayFast 的安全支付引擎集成到您的结账页面。

try {
    $payfast = new PayFastPayment(
        [
            'merchantId' => '10000100',
            'merchantKey' => '46f0cd694581a',
            'passPhrase' => '',
            'testMode' => false
        ]
    );

    $data = [
        'amount' => '100.00',
        'item_name' => 'Order#123'
    ];

    // Generate payment identifier
    $identifier = $payfast->onsite->generatePaymentIdentifier($data);

    if($identifier!== null){
        echo '<script type="text/javascript">window.payfast_do_onsite_payment({"uuid":"'.$identifier.'"});</script>';
    }
} catch(Exception $e) {
    echo 'There was an exception: '.$e->getMessage();
}

API

周期性收费

订阅支付 API 使商家能够与其账户上的订阅进行交互。

try {
    $api = new PayFastApi(
        [
            'merchantId' => '10018867',
            'passPhrase' => '2uU_k5q_vRS_',
            'testMode' => true
        ]
    );

    $fetchArray = $api->subscriptions->fetch('2afa4575-5628-051a-d0ed-4e071b56a7b0');

    $pauseArray = $api->subscriptions->pause('2afa4575-5628-051a-d0ed-4e071b56a7b0', ['cycles' => 1]);

    $unpauseArray = $api->subscriptions->unpause('2afa4575-5628-051a-d0ed-4e071b56a7b0');
    
    $cancelArray = $api->subscriptions->cancel('2afa4575-5628-051a-d0ed-4e071b56a7b0');

    $updateArray = $api->subscriptions->update('2afa4575-5628-051a-d0ed-4e071b56a7b0', ['cycles' => 1]);

    $adhocArray = $api->subscriptions->adhoc('290ac9a6-25f1-cce4-5801-67a644068818', ['amount' => 500, 'item_name' => 'Test adhoc']);

} catch(Exception $e) {
    echo 'There was an exception: '.$e->getMessage();
}

交易历史记录

交易历史记录 API 使商家能够与其 PayFast 账户进行交互。

try {
    $api = new PayFastApi(
        [
            'merchantId' => '10018867',
            'passPhrase' => '2uU_k5q_vRS_',
            'testMode' => true
        ]
    );

    $rangeArray = $api->transactionHistory->range(['from' => '2020-08-01', 'to' => '2020-08-07']);
    
    $dailyArray = $api->transactionHistory->daily(['date' => '2020-08-07']);
    
    $weeklyArray = $api->transactionHistory->weekly(['date' => '2020-08-07']);
    
    $monthlyArray = $api->transactionHistory->monthly(['date' => '2020-08']);

} catch(Exception $e) {
    echo 'There was an exception: '.$e->getMessage();
}

信用卡交易查询

信用卡交易查询 API 使商家能够查询信用卡交易。

try {
    $api = new PayFastApi(
        [
            'merchantId' => '10018867',
            'passPhrase' => '2uU_k5q_vRS_',
            'testMode' => true
        ]
    );

    $creditCardArray = $api->creditCardTransactions->fetch('1124148');

} catch(Exception $e) {
    echo 'There was an exception: '.$e->getMessage();
}

payfastsdk / payfast-php-sdk

维护者

详细信息