README

为阿尔法银行（白俄罗斯）提供的简单互联网收单助手，非官方。

需要贡献者！

（以下为英文版本）

[be_BY] Про бібліятэку

Простая бібліятэка-дапаможнік для выкарыстання інтэрнэт-эквайрынгу (онлайн аплата на сайце) праз плацёжный шлюз Альфа-Банку (Беларусь), неафіційная. Часткова пакрыта базавымі тэстамі. Мае быць стабільнай і гнуткай для пашырэння. Асноўная мэта: працаваць са зручнымі аб'ектамі (Request and Response) і мець лагіраванне памылак і іх адлюстраванне. Як вынік гэта мусіць гарантаваць больш стабільную і зручную працу для сайтаў, якія ажыццяўляюць плацяжы з дапамогай дадзенай бібліятэкі.

Праверана на беларускіх сайтах і плацёжных шлюзах. Тэарытычна павінна працаваць аналагічным чынам і ў іншых краінах, дзе існуе Альфа-Банк.

Примеры выкарыстання зможаце знайсці ў дырэкторыі "example".

Я пакіну тут зверху апісанне па-беларуску каб зменшыць магчымую колькасць выкарыстання гэтай бібліятэкі ў іншых краінах, пакуль яна не была праверана паўсюдзе. Пазней будзе дададзена дэтальнае апісанне на англійскай і расійскай мовах.

Праект далёкі да завяршэння, таму любая дапамога вітаецца і будзе карыснай. Дзякуй.

[ru_BY] Официальная информация

Банковская официальная документация: https://alfa-biz.by/acquiring/docs/merchantmanual.pdf

Официальное описание интернет-эквайринга для сайта: https://alfa-biz.by/payment/internet-acquiring/

Официальные плагины: https://alfa-biz.by/upload/cms/wordpress.zip; https://alfa-biz.by/upload/cms/opencart3%D1%85_240120.zip

[en_BY] How to use it

一些使用Acquiring API的示例可以在"example"目录中找到，有一些简单的php文件。

目标是创建API连接客户端（RbsClient）并使用它进行特定方法的操作。该库的使命是提供舒适的对象（请求和响应）来与支付网关一起工作，并具有错误日志记录（如果需要）。所有类都可以轻松扩展以满足您的需求。

目前该库远未达到最终版本。但它工作得很好，比银行供应商的PHP代码示例要好。您的任何分支/更新/评论都可能很有帮助。谢谢。

以下是一个使用示例。更多示例请参阅"example"目录。

$apiClient = (new RbsClient('test-api', 'test'));

$orderId = '570116f7-2588-768a-93a4-8b300007a120';

$response = (new OrderStatusMethod($apiClient))
->setOrderId($orderId)
->run();

print '<pre>';
var_dump($response->getOrderNumber());
var_dump($response->getOrderStatus());
var_dump($response);
print '</pre>';