README

官方Plutu SDK for PHP

Plutu PHP包提供了将Plutu服务集成到PHP项目的简化方式。它提供了一个通用的接口，使得与Plutu API和服务的交互变得简单。

入门

需求

在使用Plutu PHP包之前，您需要拥有Plutu API密钥、访问令牌和秘密密钥。您可以从Plutu账户仪表板获取这些信息。

• PHP版本8.1或更高

官方文档

Plutu API的文档可以在Plutu Docs网站上找到。

安装

您可以通过运行以下命令使用Composer安装Plutu PHP包

composer require plutu/plutu-php

用法

要在项目中使用Plutu PHP包，您首先需要包含Composer自动加载文件

require_once __DIR__ . '/vendor/autoload.php';

要为Plutu PHP设置凭据，您可以采用以下方法

use Plutu\Services\PlutuAdfali;
use Plutu\Services\PlutuSadad;
use Plutu\Services\PlutuLocalBankCards;
use Plutu\Services\PlutuTlync;
use Plutu\Services\PlutuMpgs;

// Adfali service
$api = new PlutuAdfali;
$api->setCredentials('api_key', 'access_token');
// Sadad service
$api = new PlutuSadad;
$api->setCredentials('api_key', 'access_token');
// Local Bank Cards service
$api = new PlutuLocalBankCards;
$api->setCredentials('api_key', 'access_token', 'secret_key');
// Tlync service
$api = new PlutuTlync;
$api->setCredentials('api_key', 'access_token', 'secret_key');
// MPGS service
$api = new PlutuMpgs;
$api->setCredentials('api_key', 'access_token', 'secret_key');

然后，您可以使用Plutu PHP提供的各种方法与Plutu API交互。每个Plutu服务都有不同的方法和参数，您可以在下面的examples部分查看示例。

$mobileNumber = '090000000'; // Mobile number should start with 09
$amount = 5.0; // amount in float format

try {

    $api = new PlutuAdfali;
    $api->setCredentials('api_key', 'access_token');
    $apiResponse = $api->verify($mobileNumber, $amount);

    if ($apiResponse->getOriginalResponse()->isSuccessful()) {
        // Process ID should be sent in the confirmation step
        $processId = $apiResponse->getProcessId();
    } elseif ($apiResponse->getOriginalResponse()->hasError()) {
        $errorCode = $apiResponse->getOriginalResponse()->getErrorCode();
        $errorMessage = $apiResponse->getOriginalResponse()->getErrorMessage();
    }

// Handle exceptions that may be thrown during the execution of the code
} catch (\Exception $e) {
    $exception = $e->getMessage();
}

示例

Plutu PHP包包含几个示例，展示了如何使用该包与Plutu API交互。这些示例涵盖了Plutu服务的各种用例。您可以在示例文档中找到这些示例。

每个示例都包含带有解释的代码片段以及完整源代码的链接。我们建议您查看这些示例，以更好地了解如何在您的项目中使用此包。

示例列表

• 用法
• 初始化
• 服务
  • Adfali支付服务
    • 验证流程（发送OTP）
    • 确认流程（支付）
  • Sadad支付服务
    • 验证流程（发送OTP）
    • 确认流程（支付）
  • 本地银行卡支付服务
    • 确认（支付）
    • 回调处理程序
  • T-Lync支付服务
    • 确认（支付）
    • 回调处理程序
    • 返回处理程序
  • MPGS支付服务
    • 确认（支付）
    • 回调处理程序
• 异常和错误处理

官方集成

以下集成由Plutu团队完全支持和维护。

• Plutu Laravel

资源

• Plutu Docs

许可

Plutu PHP包是开源软件，根据MIT许可证授权。