README

这是一个库，包含了通过 OpenAPI 可用的所有 Tpay 方法 Tpay。

安装

通过 Composer 安装

composer require tpay-com/tpay-openapi-php

通过 SSH 通过 Git 安装

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

通过 HTTPS 通过 Git 安装

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

手动下载： https://github.com/tpay-com/tpay-openapi-php/archive/master.zip

配置

您需要做的唯一事情是设置您的 OAuth 凭证，例如在示例配置文件中（见示例）。您可以在 Tpay 的商户面板中生成访问密钥。

src/Loader.php 文件处理所有必需的类加载，因此您可以将其包含在任何您正在编辑的文件中。

您可以通过运行库中的方法之一轻松执行 Tpay OpenAPI 文档中描述的所有方法，例如

$tpayApi = new TpayApi($clientId, $clientSecret, true, 'read');
$transactions = $tpayApi->Transactions->getTransactions();

当前所有可用的 API 方法在 Examples 目录中都有示例用法。

示例凭据

对于所有 API 调用

  Client id: 1010-e5736adfd4bc5d8c
  Client secret: 493e01af815383a687b747675010f65d1eefaeb42f63cfe197e7b30f14a556b7

对于通知验证

  Confirmation code: demo

对于信用卡加密

  Public Key: LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0NCk1JR2ZNQTBHQ1NxR1NJYjNEUUVCQVFVQUE0R05BRENCaVFLQmdRQ2NLRTVZNU1Wemd5a1Z5ODNMS1NTTFlEMEVrU2xadTRVZm1STS8NCmM5L0NtMENuVDM2ekU0L2dMRzBSYzQwODRHNmIzU3l5NVpvZ1kwQXFOVU5vUEptUUZGVyswdXJacU8yNFRCQkxCcU10TTVYSllDaVQNCmVpNkx3RUIyNnpPOFZocW9SK0tiRS92K1l1YlFhNGQ0cWtHU0IzeHBhSUJncllrT2o0aFJDOXk0WXdJREFRQUINCi0tLS0tRU5EIFBVQkxJQyBLRVktLS0tLQ==

使用示例

前端表单和支付处理器

支付方式选择表单、BLIK 方式表单、简单的信用卡表单、扩展的信用卡表单、定期支付示例、支付通知 webhook。

商户账户注册（仅限合作伙伴）

使用示例.

日志

库有自己的日志系统来保存所有 API 调用、响应、webhook 通知和异常。请确保 Logs 目录可写，并将规则添加到 Apache .htaccess 或 NGINX 以阻止浏览器访问此区域。日志文件是为每天单独创建的。

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

Logger::disableLogging();

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

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

日志文件名将自动分配。

您可以通过设置自己的 Psr\Log\LoggerInterface 实现来替换上面的日志系统

Logger::setLogger($logger);

自定义模板和静态文件路径

您可以设置自己的模板路径，因此您可以将此库中的 phtml 模板文件复制并修改。

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

您可以设置自己的静态文件路径，这样您就可以从这个库中复制并修改 css 和 js 文件。默认情况下，路径基于 $_SERVER['REQUEST_URI'] 的值。

Util::$libraryPath = '/my/own/path/';

语言

该库支持两种语言（英语和波兰语）。默认语言为英语。更改语言示例

// Any time you construct the class providing payment forms, you can pass the language in constructor
$paymentForms = new PaymentForms('pl');
// After this line all static messages (input labels, buttons titles etc.) will be displayed in Polish

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

许可证

本库采用 MIT 许可证发布。

tpay-com / tpay-openapi-php

维护者

详细信息