README

致谢

开发由 AsisTeam s.r.o. 支持。请随意使用。欢迎您的贡献。请随意发布 pull requests。

概述

此 PHP API 封装允许您使用 CSOB 商业连接器 PDF 官方实现文档。

此库遵循官方文档，并允许您

• 列出和读取来自 CEB 的文件（AVIZO，VYPIS）
• 生成并上传支付订单到 CEB

请参阅 商业连接器 API - 使用文档

安装

composer require asisteam/csob-bc

版本

测试

检查代码质量和运行测试

composer phpstan-install
composer ci

或者单独运行

composer qa
composer phpstan-install
composer phpstan
composer tests

注意：由于集成测试会向真实 API 端点发送请求，因此将跳过集成测试。集成测试中的断言有效性也可能发生变化。

示例用法

// use factory to create CEB instance
// factory creates and registers file readers and generators so you don't have to do it manually
$options = new Options('path/to/bccert.pem', 'certPassPhrase', 'contractId', 'appGuid');
$factory = new CEBFactory($options, '/tmp/dir/path');
$ceb = $factory->create();

// returns API response with files listed in CEB API
$list = $ceb->listFiles();
Assert::count(2, $list->getFiles());

// You can read and parse files content

// first one is VYPIS type
$as = $ceb->downloadAndRead($list->getFiles()[0]);
Assert::true($as instanceof IReport);
// You can iterate entries and get details about each transaction
Assert::count(11, $as->getEntries());

// second one is AVIZO type
$adv = $ceb->downloadAndRead($list->getFiles()[1]);
Assert::true($adv instanceof IAdvice);
// You can iterate entries and get details about each transaction
Assert::count(3, $adv->getTransactions());

// generate and upload payment batch file to CEB
$payments = []; // create list of IPaymentOrder entities eg by: new InlandPayment(...)
$file = $ceb->generatePaymentFile($payments);
$ceb->upload([$file]);

作者