README

适用于 Tpay 中所有支付方式的库。[Tpay 文档](https://docs.tpay.com/)

波兰语版本 🇵🇱 wersja polska

安装

通过 Composer 安装

composer require tpay-com/tpay-php

通过 SSH 使用 Git 安装

git clone git@github.com:tpay-com/tpay-php.git

通过 HTTPS 使用 Git 安装

git clone https://github.com/tpay-com/tpay-php.git

手动下载：[master.zip](https://github.com/tpay-com/tpay-php/archive/master.zip)

配置

您只需通过 $this- 设置您的 API 访问数据 (示例)。您可以在 Tpay 的商户面板中生成访问密钥。[Tpay 商户面板](https://secure.tpay.com/panel)

loader.php 文件处理所有必需的类加载，因此您可以将此文件包含在任何您正在编辑的文件中。（请确保正确配置当前工作路径）。

您可以在主 src 目录中通过扩展所需的类轻松执行 Tpay 文档中描述的所有方法。[示例](https://github.com/tpay-com/tpay-php/blob/HEAD/examples)

基本支付和银行选择表单

使用示例：[基本表单](https://github.com/tpay-com/tpay-php/blob/HEAD/examples/BasicPaymentForm.php)，[银行选择 HTML 表单](https://github.com/tpay-com/tpay-php/blob/HEAD/examples/BankSelection.php)，[银行选择 API 表单](https://github.com/tpay-com/tpay-php/blob/HEAD/examples/BankSelectionAPI.php)，[BLIK 表单](https://github.com/tpay-com/tpay-php/blob/HEAD/examples/BlikTransactionExample.php)。

交易 API / 创建、获取、退款、报告

使用示例：[创建交易](https://github.com/tpay-com/tpay-php/blob/HEAD/examples/TransactionApiExample.php)，[退款交易](https://github.com/tpay-com/tpay-php/blob/HEAD/examples/TransactionRefund.php)，[退款交易状态](https://github.com/tpay-com/tpay-php/blob/HEAD/examples/TransactionRefundStatus.php)。

卡基本 / 网上卡

使用示例：[卡基本表单](https://github.com/tpay-com/tpay-php/blob/HEAD/examples/CardBasic.php)，[网上卡网关](https://github.com/tpay-com/tpay-php/blob/HEAD/examples/CardGate.php)，[卡支付链接生成器](https://github.com/tpay-com/tpay-php/blob/HEAD/examples/CardPaymentLinkBuilder.php)，[带有已保存卡的网上卡网关](https://github.com/tpay-com/tpay-php/blob/HEAD/examples/CardGateExtended.php)。

日志

库有自己的日志系统，用于保存 Tpay.com 服务器发送的所有确认和通知，出站请求和异常。请确保 src/Logs 目录可写，并添加规则到 Apache .htaccess 或 NGINX 以阻止浏览器访问此区域。日志文件将单独在 Logs 目录下创建。

默认情况下启用了日志记录，但您可以使用以下命令禁用此功能

Logger::disableLogging();

您还可以通过此命令设置自己的日志路径

Logger::setLogPath('/my/own/path/Logs/');

您还可以通过此命令设置自己的 Logger，它必须与 Psr\Log\LoggerInterface 兼容

Logger::setLogger(new CustomLogger());

日志文件名将自动分配。

自定义模板路径

您可以为自定义模板路径设置，这样您就可以从本库复制并修改 phtml 模板文件。

Util::$customTemplateDirectory = '/my/own/templates/path/';

语言

目前，该库支持两种语言（英语和波兰语）。默认语言是英语。更改语言的示例

// All Tpay class constructors load Lang class
$tpay = new BankSelectionExample();

// After this line all static messages (input labels, buttons titles etc.) will be displayed in Polish
(new Util())->setLanguage('pl');

// If you want to access translations manually, use:
$language = new Lang();
$language->setLang('pl'); // for setting language
$language->l('pay'); // to echo translated key

许可证

此库根据 MIT 许可证 发布，但使用了在各自条款下分发的第三方库（请参阅 LICENSE-3RD-PARTY.md）。