Подключение Chronopay

ChronoPay — международный платёжный провайдер с готовым обработчиком в модуле sale. Подключение сводится к трём вещам: завести платёжную систему в админке, прописать параметры мерчанта (Product ID и shared secret) и настроить обратный callback, по которому Битрикс переведёт заказ в статус «оплачен».

Что такое обработчик ChronoPay и когда он нужен

ChronoPay работает по классической схеме redirect-эквайринга: покупатель уходит на платёжную страницу провайдера, вводит данные карты там, а магазин получает только результат — успех или отказ. Карточные данные на вашем сайте не хранятся, что снимает основную часть требований PCI DSS.

В 1С-Битрикс для ChronoPay есть штатный обработчик платёжной системы — отдельный класс в модуле sale. Вам не нужно писать интеграцию с нуля: достаточно создать платёжную систему на базе этого обработчика и заполнить реквизиты, которые выдал провайдер в личном кабинете.

• Product ID — идентификатор товара/сайта в системе ChronoPay;
• Shared secret — секретное слово для формирования и проверки MD5-подписи;
• Валюта платежа (обычно совпадает с валютой заказа);
• URL callback — адрес на вашем сайте, куда ChronoPay сообщает о статусе.

Что подготовить до настройки

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

1. Договор с ChronoPay и активированный аккаунт мерчанта.
2. Product ID и shared secret из личного кабинета провайдера.
3. Согласованные с менеджером ChronoPay адреса возврата: success/fail URL и URL для служебного уведомления (callback).
4. Работающий HTTPS на домене — без валидного сертификата платёжная страница и колбэки корректно работать не будут.

Создание платёжной системы в админке

Зайдите в Магазин → Настройки → Платёжные системы (в старых сборках — Сервисы → Платёжные системы) и нажмите «Добавить платёжную систему».

Заполните базовые поля карточки:

• Название и код — например, chronopay; по этому коду систему потом привязывают к типам плательщиков;
• Обработчик — выберите ChronoPay из списка;
• Тип плательщика — отметьте те, для кого будет доступна оплата картой (обычно «Физическое лицо»);
• Активность — включите, когда закончите с реквизитами.

После выбора обработчика Битрикс подставит его настроечную форму — набор полей, которые описаны в файле профиля обработчика. Именно там вводятся Product ID, shared secret и валюта.

Параметры обработчика и MD5-подпись

Обработчик ChronoPay при формировании платежа собирает строку из параметров заказа и вычисляет по ней контрольную сумму MD5 с использованием shared secret. Провайдер повторяет тот же расчёт на своей стороне — если суммы не совпадают, платёж отклоняется. Поэтому реквизиты нужно вводить символ в символ.

В настроечной форме почти каждое поле можно задать двумя способами: «Из настроек» — фиксированное значение (так вводят Product ID и secret) или «Из свойства заказа» — динамическая привязка к полю заказа (так подставляют сумму, валюту, номер заказа). Проверьте, что сумма и валюта берутся именно из заказа, а не заданы константой.

Настройка callback и статуса оплаты

Redirect покупателя обратно на сайт — это ещё не оплата. Факт списания магазин узнаёт из служебного callback (server-to-server уведомления), который ChronoPay отправляет на заранее согласованный URL. Результирующая страница обработчика принимает этот запрос, повторно считает MD5-подпись и сверяет её с присланной.

1. ChronoPay шлёт POST/GET на URL результата с параметрами платежа и подписью.
2. Обработчик проверяет подпись по shared secret — так отсекаются поддельные уведомления.
3. При совпадении вызывается регистрация оплаты, и заказ переходит в статус «оплачен» (PAYED = Y).

Адрес callback указывается в личном кабинете ChronoPay, а не только в Битрикс. Обычно это путь вида /bitrix/tools/sale_ps_result.php с параметрами, идентифицирующими платёжную систему и заказ.

Тестирование и запуск в бой

Прогоните полный цикл в тестовом окружении провайдера прежде, чем включать приём реальных карт. Тестовый режим у ChronoPay задаётся отдельными реквизитами (тестовый Product ID/secret) и тестовыми номерами карт из документации провайдера.

• Оформите заказ и убедитесь, что открывается платёжная страница с корректной суммой и валютой;
• Проведите оплату тестовой картой и проверьте, что callback пришёл, а заказ перешёл в «оплачен»;
• Проверьте сценарий отказа — заказ должен остаться неоплаченным без ошибок;
• Загляните в Магазин → Настройки → Журнал и в /bitrix/modules/sale/pay_system.log (если логирование включено), чтобы увидеть входящие запросы.

При переключении на боевые реквизиты не забудьте сменить и адреса callback в кабинете ChronoPay на production-домен, а также отключить тестовый режим в карточке платёжной системы.

Типичные проблемы и диагностика

Большинство инцидентов на ChronoPay диагностируются по одному и тому же принципу — сверить, что ушло на провайдера, с тем, что вернулось.

Полезно временно включить логирование обработчика и посмотреть сырые параметры входящего callback. Если запрос вообще не появляется в логах — проблема сетевая: проверьте доступность URL результата с внешнего хоста и правила фаервола/WAF, которые могут блокировать серверные запросы провайдера.

Итог

Подключение ChronoPay к 1С-Битрикс — это создание платёжной системы на штатном обработчике, аккуратный ввод Product ID и shared secret, настройка обратного callback и обязательный прогон полного цикла в тесте. Ключевые точки риска — MD5-подпись и доставка callback: именно из-за них деньги списываются, а заказ остаётся неоплаченным.

Если нужно подключить ChronoPay без простоев, доработать нестандартную подпись или свести несколько платёжных систем в один магазин, мы возьмём настройку и тестирование на себя — от карточки платёжной системы до боевого запуска и мониторинга колбэков.