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

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

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

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

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

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

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

ps_id устанавливается в зависимости от платёжной системы, через которую проходит платёж (например, через Qiwi, Яндекс.Деньги или WebMoney) либо в зависимости от банка-эквайера, через который принимается оплата.

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

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

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

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

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

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

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

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

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

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

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

Ваша заявка успешно принята Менеджер скоро свяжется с вами

Что-то пошло не так Попробуйте еще раз