Прием платежей на сайте. Подключение Z-Payment

Процесс регистрации в системе Z-Payment рассматривать не будем, если возникнут вопросы, то опишу в отдельной статье. В ходе работы мы будем придерживаться алгоритма, составленного ранее.

Итак, первое, что нам нужно сделать, это создать новый магазин для нашего сайта. Для этого авторизуемся в платежной системе, переходим по ссылке “Мои магазины” и нажимаем на кнопку “Создать магазин“, после мы попадаем на такую форму:

Создание магазина в Z-Payment, шаг 1

Поля “Название сайта“, “URL сайта” и “Краткое описание” являются обязательными до заполнения, причем первые два из них изменить в последующем можно будет только через службу технической поддержки, поэтому проверяйте правильность заполнения. Заполнив все поля переходим “Далее“.

Создание магазина в Z-Payment, шаг 2

На втором этапе нам необходимо заполнить всю техническую информацию, это указать адреса уведомлений Result URL и перенаправления Success URL и Fail URL, также необходимо указать метод передачи данных на эти адреса POST/GET, указать секретный ключ и пароль, которые будут использовать при проверке подлинности передаваемых данных. После того как все заполнили и проверили нажимаем кнопку “Далее“.

Создание магазина в Z-Payment, шаг 3

На третьем этапе платежная система предлагает нам заново проверить все заполненные данные и в случае ошибки, вернутся назад на нужный шаг. Если все хорошо и ошибок нету, нажимаем “Добавить магазин“.

Создание магазина в Z-Payment, шаг 4

На четвертом этапе добавления нам необходимо провести активацию нашего магазина. Для этого размещаем указанный код у себя на сайте и подтверждаем активацию. После нас перекидывает на настройку способов оплаты и комиссий.

Создание магазина в Z-Payment, шаг 5

Сразу после создания, магазин имеет ранг 1, поэтому большинство платежных сервисов нам недоступны для приема оплаты. Чтобы повысить ранг, нам необходимо на нашем сайте создать раздел контакты и указать туда наши контакты, в том числе и физический адрес, после этого менеджеры системы выдадут магазину ранг 3, что откроет доступ ко всем способам оплаты.

Магазин создан, то есть первый пункт нашего плана выполнен, переходим ко второму, а именно созданию формы оплаты заказа. В форме нам необходимо указать идентификатор нашего магазина в системе Z-Payment, идентификатор заказа на нашем сайте, сумма заказа, описание и клиентский электронный адрес на который будут приходить письмо об оплате. Пример формы ниже (файл form.php),

После нажатия на кнопку “Оплатить” пользователь попадает уже на страницу платежной системы, где ему предлагается выбрать удобный способ оплаты с последующими инструкциями.

Теперь нам нужно подготовить страницы, которые будут проверять статус платежа и выводить соответствующее сообщение. После оплаты счета, Z-Payment пришлет нам уведомление по ссылке, которую мы указали в пункте Result URL, эта ссылка будет проверять подлинность полученных данных и в положительном случае менять статус заказа на оплаченный. Ключевым моментом в этой задаче является проверка подлинности передаваемых данных, для это нужно сгенерировать контрольную подпись и сравнить её с полученным хешем. Контрольная подпись в Z-Payment формируется следующим образом:

После проверки контрольной подписи, выполняем все необходимые операции с полученными данными. Примерный код файла result.php представлен ниже:

Также нам остается создать два вспомогательных файла, это success.php и fail.php, на которые пользователя будет перенаправлять платежная система, в случае успешных действия и ошибки соответственно. Никаких сложных обработок в них делать не будем, просто вывод сообщений.

Файл success.php:

Файл fail.php:

Стоит отменить, что в файлах используется объект класса $order, этот класс вы пишите сами, здесь он указан в качестве примера. На этом с подключением системы Z-Payment мы закончили, осталось только совершить тестовый платеж и перевести магазин в рабочий режим.

Скачать исходники: GitHub

загрузка комментариев