README

Secupay PHP 库

Secupay PHP 库封装了 Secupay API。此库简化了您与交易、账户和订阅等各种服务的交互。

文档

Secupay Web 服务 API

要求

PHP 5.6.0 及以上版本

安装

您可以使用 Composer 或 手动安装

Composer

首选方法是通过 composer。如果您尚未安装 composer，请按照安装说明进行操作。

安装 composer 后，在项目根目录中执行以下命令以安装此库

composer require secupay/sdk

手动安装

您也可以下载整个包。在发布页面上列出了所有稳定版本。

解压缩您下载的 zip 文件，并在您的项目中包含自动加载器

require_once '/path/to/php-sdk/autoload.php';

用法

需要使用您的账户空间 ID、用户 ID 和密钥配置库，这些信息可在您的 Secupay 账户仪表板中找到。将 space_id、user_id 和 api_secret 设置为其值。

配置服务

require_once(__DIR__ . '/autoload.php');

// Configuration
$spaceId = 405;
$userId = 512;
$secret = 'FKrO76r5VwJtBrqZawBspljbBNOxp5veKQQkOnZxucQ=';

// Setup API client
$client = new \Secupay\Sdk\ApiClient($userId, $secret);

// Get API service instance
$client->getTransactionService();
$client->getTransactionPaymentPageService();

要开始发送交易，请参阅以下示例

require_once(__DIR__ . '/autoload.php');

// Configuration
$spaceId = 405;
$userId = 512;
$secret = 'FKrO76r5VwJtBrqZawBspljbBNOxp5veKQQkOnZxucQ=';

// Setup API client
$client = new \Secupay\Sdk\ApiClient($userId, $secret);

// Create transaction
$lineItem = new \Secupay\Sdk\Model\LineItemCreate();
$lineItem->setName('Red T-Shirt');
$lineItem->setUniqueId('5412');
$lineItem->setSku('red-t-shirt-123');
$lineItem->setQuantity(1);
$lineItem->setAmountIncludingTax(29.95);
$lineItem->setType(\Secupay\Sdk\Model\LineItemType::PRODUCT);


$transactionPayload = new \Secupay\Sdk\Model\TransactionCreate();
$transactionPayload->setCurrency('EUR');
$transactionPayload->setLineItems(array($lineItem));
$transactionPayload->setAutoConfirmationEnabled(true);

$transaction = $client->getTransactionService()->create($spaceId, $transactionPayload);

// Create Payment Page URL:
$redirectionUrl = $client->getTransactionPaymentPageService()->paymentPageUrl($spaceId, $transaction->getId());

header('Location: ' . $redirectionUrl);

HTTP 客户端

您可以使用 php curl 或 php socket 扩展。建议您安装必要的扩展并在系统上启用它们。

有两种方式可以指定您首选的 HTTP 客户端。

$userId = 512;
$secret = 'FKrO76r5VwJtBrqZawBspljbBNOxp5veKQQkOnZxucQ=';

// Setup API client
$client = new \Secupay\Sdk\ApiClient($userId, $secret);

$httpClientType = \Secupay\Sdk\Http\HttpClientFactory::TYPE_CURL; // or \Secupay\Sdk\Http\HttpClientFactory::TYPE_SOCKET

$client->setHttpClientType($httpClientType);

//Setup a custom connection timeout if needed. (Default value is: 25 seconds)
$client->setConnectionTimeout(20);

您还可以通过 SCP_HTTP_CLIENT 环境变量指定 HTTP 客户端。可能的字符串值是 curl 或 socket。

<?php
putenv('SCP_HTTP_CLIENT=curl');
?>

将 Webhook 负载签名机制集成到 Webhook 回调处理程序中

现在发送给实体状态变更的 HTTP 请求包含了一个额外的字段 state，它提供了关于监视的实体状态更新的信息。这种增强是实施我们 Webhook 加密机制的结果。

负载字段 state 提供了关于实体状态更新的直接信息，使得通过额外的 API 调用来检索实体状态变得冗余。

⚠️ 警告：通用伪代码

提供的伪代码故意是通用的，旨在说明增强您的 API 以利用 Webhook 负载签名的过程。它不是一个完整的实现。

请确保根据您的应用程序的具体需求（包括适当的安全措施和错误处理）对代码进行修改和扩展。为了深入了解 Webhook 负载签名机制，我们强烈建议您参考我们的全面 Webhook 负载签名文档。

public function handleWebhook() {
    $requestPayload = file_get_contents('php://input');
    $signature = $_SERVER['HTTP_X_SIGNATURE'] ?? '';

    if (empty($signature)) {
        // Make additional API call to retrieve the entity state
        // ...
    } else {
        if ($client->getWebhookEncryptionService()->isContentValid($signature, $requestPayload)) {
            // Parse requestPayload to extract 'state' value
            // $state = ...
            // Process entity's state change
            // $this->processEntityStateChange($state);
            // ...
        }
    }

    // Process the received webhook data
    // ...

}

许可证

有关更多信息，请参阅许可证文件。

secupay / sdk

维护者

详细信息