Приём POST оповещений

При каждом принятом платеже PayKeeper может отправлять POST-запрос на указанный URL предприятия.
Для этого необходимо включить данную функцию в личном кабинете предприятия.

В запросе от PayKeeper будут передаваться следующие данные:

Поле key — цифровая подпись запроса. Она является md5-хешем, который вычисляется от конкатенации параметров 1–4 с добавлением в конец секретного слова. Секретное слово также настраивается в личном кабинете PayKeeper.

Обязательно нужно проверять, что sum, clientid и orderid соответствуют друг другу в вашей информационной системе. То есть, если было получено оповещение об успешном платеже по заказу номер orderid, нужно проверить, что он действительно есть, что его сумма действительно совпадает с полученной суммой оплаты sum, что он принадлежит пользователю clientid. Если ваша система не использует идентификацию заказов или пользователей, проверяйте только релевантные для вашего случая параметры.

Помимо вышеуказанных, в POST-оповещении передаются следующие дополнительные параметры:

Если параметр отмечен как необязательный, то в запросе он может отсутствовать, либо быть пустым. Поля clientid, orderid, service_name, client_email, client_phone будут те же, что и при инициализации платежа.

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

batch_date передается в том случае, если платёжная платформа PayKeeper работает в двухстадийном режиме оплаты (режим «авторизация + списание»). В этом режиме успешная оплата является операцией авторизации денежных средств, которые по прошествии заданного периода времени должны быть списаны с карты плательщика. batch_date в этом случае представляет собой дату запланированного списания платежа.

fop_receipt_key передается в том случае, если платёжная платформа интегрирована с онлайн-кассой. С помощью fop_receipt_key формируется постоянный адрес страницы с чеком 54-ФЗ по данному платежу.

Если в процессе оплаты была создана привязка карты, то дополнительно передаётся bank_id — идентификатор созданной привязки карты и/или bank_payer_id — идентификатор созданной привязки клиента. Эти реквизиты понадобятся при выполнении платежа по привязанной карте и/или по всем привязанным картам клиента. Если платёж происходит с уже привязанной карты, то в bank_id будет передаваться идентификатор использованной привязки карты, а в bank_payer_id — привязки клиента со всеми картами, сохраненными к нему.

Параметры  card_number, card_holder, card_expiry могут быть заполнены соответственно маскированным номером карты, именем держателя карты и сроком действия карты плательщика, если использующийся шлюз банка эти данные передаёт.

В ответ на данный запрос должна быть отправлена строка вида:

где hash вычисляется как md5-хеш от конкатенации поля id запроса и того же секретного слова, а слово «OK» состоит из английских букв O и K. Такой ответ считается подтверждением того, что информационная система предприятия приняла данный платёж. Пример составления ответа на PHP:

В случае, если на запрос не будет получен корректный ответ, PayKeeper будет продолжать попытки сообщить о платеже, повторяя запрос каждую минуту. Если через определённое число попыток (50 по умолчанию) не будет получен корректный ответ, платёж в PayKeeper получит статус «Совершён без оповещения». Такой платёж можно повторно провести через веб-интерфейс администратора.

Например, на языке PHP приём оповещений можно реализовать так:

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

Другие типы уведомлений

Существует так же возможность настроить уведомления о произведённых возвратах и неуспешных платежах (в статусе «Не состоялся»). Для настройки таких уведомлений необходимо обратиться в службу поддержки PayKeeper.