Прием платежей на сайте через сервис, с которым программа ExaHotel не интегрирована

Ниже описывается настройка приема платежей на сайте при использовании модуля бронирования, когда используется платежный сервис или собственная система учета в вашей организации, с которыми в ExaHotel нет прямой интеграции. Список платежных сервисов, с которыми программа ExaHotel интегрирована, можно посмотреть здесь: Прием платежей на сайте.

Для создания вашей собственной интеграции платежного сервиса с программой ExaHotel нужно создать файл *.php. Именно на эту страницу будет переходить клиент для совершения платежа. Этот файл будет принимать информацию о заказе и сумму к оплате. Внутри файла нужно сделать собственную обработку приема платежа: передать эти данные в платежный сервис, отобразить форму платежа или передать данные в систему учета вашей организации.

Разместите созданный файл *.php на сайте вашей организации.

Дайте программе знать об этом файле. Для этого настройте параметры, как указано в инструкции: Прием платежей на сайте. При этом нужно выбрать платежный сервис Другое и указать адрес размещенного php-файла.

Передача параметров

Чтобы файл *.php принимал информацию о заказе и сумму к оплате, нужно добавить макросы в адрес этого файла. Поддерживаются следующие макросы:

• {DB} - идентификатор базы данных. Требуется, если у вас несколько баз данных в ExaHotel.
• {ID} - идентификатор заказа. Это внутренний идентификатор записи в ExaHotel, например, pQqg84J4uMa16qUYQje0TH.
• {ORDERKEY} - номер заказа. Используется для отображения клиенту.
• {SUMMTOPAY} - сумма к оплате. Копейки отделяются от рублей точкой.

Например, если путь вашего файла был https://mycompanysite.ru/pay.php, то добавьте параметры с макросами для передачи номера заказа и стоимости: https://mycompanysite.ru/pay.php?id={ID}&key={ORDERKEY}&summ={SUMMTOPAY}.

Тогда внутри php-файла можно вывести информацию о заказе таким образом:

<?php
    echo 'Оплата заказа'.$_GET['key'].' на сумму '.$_GET['summ'];
?>

Обратная связь

Это необязательно, но очень удобно: можно сделать так, чтобы по успешному завершению платежа платеж сразу попал в вашу базу данных ExaHotel и привязался к заказу.

После успешного платежа вызовите страницу http://exacode.ru/exapayment/success.php, передав в нее параметры, указанные ниже. Параметры можно передать как GET-способом, так и POST-способом.

• global_order_id - глобальный идентификатор заказа. Это строка из трех частей, разделенных двоеточием: приложение, идентификатор базы данных, идентификатор заказа.
• bank_transaction_id - это идентификатор транзакции в платежной системе или в собственной системе учета в вашей организации.
• summ - оплаченная сумма.

Пример вызова GET-способом:

http://exacode.ru/exapayment/success.php?global_order_id=ExaHotel:htdemo:pQqg84J4uMa16qUYQje0TH&bank_transaction_id=1234567&summ=1000.50

Если же платеж был неуспешным, вызовите страницу http://exacode.ru/exapayment/fail.php, передав в нее только параметр global_order_id.