README

Trust Payments PHP 库

Trust Payments PHP 库围绕 Trust Payments API 构建。此库简化了您与交易、账户和订阅等各项服务交互的过程。

文档

Trust Payments Web 服务 API

要求

• PHP 5.6.0 及以上版本

安装

您可以使用 Composer 或 手动安装

Composer

首选方法是通过 composer。如果您尚未安装 composer，请遵循 安装说明。

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

composer require trustpayments/sdk

手动安装

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

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

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

使用

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

配置服务

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

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

// Setup API client
$client = new \TrustPayments\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 \TrustPayments\Sdk\ApiClient($userId, $secret);

// Create transaction
$lineItem = new \TrustPayments\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(\TrustPayments\Sdk\Model\LineItemType::PRODUCT);


$transactionPayload = new \TrustPayments\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 \TrustPayments\Sdk\ApiClient($userId, $secret);

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

$client->setHttpClientType($httpClientType);

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

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

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

许可证

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