Инструкция к модулю Платежи через PaySys.uz

Что делает модуль

Модуль добавляет в CS-Cart платёжный процессор PaySys.uz. Покупатель оформляет заказ в магазине, выбирает соответствующий способ оплаты и переходит на страницу PaySys.uz для завершения платежа.

Модуль работает как внешний redirect-процессор: он формирует запрос на платёжную страницу PaySys.uz, подписывает его API-ключом и передаёт параметры заказа. В коде модуля нет отдельного callback/webhook-обработчика для автоматического подтверждения оплаты, возвратов, холдирования или фискализации.

Где находится модуль

Основная настройка выполняется в способе оплаты:

1. Откройте Администрирование → Способы оплаты.

2. Создайте или откройте способ оплаты PaySys.uz.

3. В поле процессора выберите PaySys.uz. В списке процессоров он отображается в группе MakeShop.pro.

4. Заполните параметры процессора.

Параметры способа оплаты

Идентификатор магазина — это VENDOR_ID, выданный PaySys.uz для магазина. Модуль передаёт это значение в платёжную систему при создании платежа.

API-ключ используется для формирования подписи запроса. Подпись строится из API-ключа, идентификатора магазина, номера заказа, суммы, валюты и времени подписи.

Режим тестирования переключает адрес, на который отправляется платёжный запрос: рабочий адрес https://agr.uz/pay или тестовый адрес https://agr.uz/sandbox.

Как проходит оплата

1. Покупатель оформляет заказ и выбирает способ оплаты PaySys.uz.

2. CS-Cart создаёт заказ.

3. Модуль получает данные заказа и настройки способа оплаты.

4. В PaySys.uz передаются идентификатор магазина, номер заказа, сумма, валюта sum, название способа оплаты, ссылка возврата, время подписи и MD5-подпись запроса.

5. Перед перенаправлением модуль переводит заказ в статус Открыт.

6. Покупатель переходит на страницу PaySys.uz и завершает оплату там.

7. После внешнего сценария оплаты покупатель возвращается в магазин по ссылке завершения заказа.

Статусы, callback и webhook

В модуле нет отдельной настройки webhook/callback URL и нет обработчика, который принимает уведомление от PaySys.uz и автоматически меняет статус заказа после успешной оплаты.

Заказ переводится в статус Открыт до перехода покупателя на PaySys.uz. Если процесс PaySys.uz требует сверки оплаты, её нужно организовать по правилам платёжной системы и внутренним регламентам магазина.

Возвраты, hold/capture и отмены

Модуль не реализует отдельные операции возврата, отмены, холдирования, capture или void из интерфейса заказа CS-Cart. Все такие операции, если они доступны, выполняются вне модуля — на стороне PaySys.uz или по процедурам платёжного провайдера.

Чеки и фискализация

В коде модуля нет отдельных настроек для 54-ФЗ, DigitalKassa, фискальных чеков или передачи состава заказа в кассовый сервис. Модуль передаёт в PaySys.uz только параметры платежа, необходимые для перенаправления покупателя.

Как проверить работу

1. Включите тестовый режим в способе оплаты.

2. Укажите тестовые VENDOR_ID и API-ключ, полученные от PaySys.uz.

3. Создайте тестовый заказ на витрине и выберите оплату PaySys.uz.

4. Убедитесь, что заказ создан в CS-Cart и получил статус Открыт.

5. Проверьте, что покупатель перенаправляется на https://agr.uz/sandbox.

6. После проверки тестового сценария выключите тестовый режим и замените реквизиты на рабочие.