Помощь по работе с API

Создание платежа

Для инициализации платежа посредством единой формы оплаты, вам достаточно направить пользователя по специальному URL, а также передать ряд обязательных для оплаты параметров.

https://paylite.ru/pay/pay?public_key=11111-1&account=demo&sum=10&desc=Описание платежа

  • public_key – публичный ключ, можно получить в настройках проекта.
  • sum – сумма платежа.
  • desc – Описание заказа. Используется только для информирования при совершении платежа.

Данные чека
После инициализации оплаты пользователь переходит на страницу чека, где происходит отслеживание статуса платежа.

При получении успешного либо ошибочного статуса пользователь перенаправляется на сайт партнера (поля Fail URL/Success URL в настройках личного кабинета) с GET параметрами:

  • account – Идентификатор абонента в системе партнера который был передан при оплате
  • paymentId – номер платежа в системе PayLite

Подтверждение платежа

По мере выполнения платежа мы уведомляем платформу магазина о статусе оплаты. Запросы последовательно отправляются на URL вашего обработчика (задается в настройках проекта). Первым выполняется CHECK, после успешного ответа и списания средств с клиента выполняется запрос PAY, при любой ошибке в ходе проведения платежа выполняетcя запрос ERROR.

CHECK - Проверка возможности оказания услуги абоненту, Вы должны подтвердить готовность системы (проверить корректность суммы платежа, существование счета в БД и т.д.).

PAY - Уведомление об успешном списании, Вы должны оказать услугу абоненту. При любой ошибке на данном этапе (например не доступна БД) платеж получает статус «незавершен», после устранения проблем Вы можете повторно провести платеж в статистике.

ERROR - Ошибка платежа на любом из этапов. Если ошибка вызвана пустым/ошибочным ответом сервера партнера, то запрос отправлен не будет. Следует учесть, что данный статус не конечный и возможны ситуации когда после запроса ERROR может последовать запрос PAY.


https://адрес_вашего_обработчика?

  method=check
  &params[account]=user
  &params[projectId]=1
  &params[sum]=100
  &params[sign]=9bdf52a4830779a1383ac24f1b3ed054
  &params[payliteId]=1234567

  • method – один из методов.
  • projectId – ID вашего магазина в системе PayLite.
  • payliteId – Внутренний номер платежа в PayLite.
  • account – Идентификатор абонента в системе партнера.
  • sum – Сумма списания с лицевого счета абонента, в руб.
  • paymentType – Система в которой производилась оплата.
  • sign – Цифровая подпись. Образуется как md5-хеш от склеивания значения account, sum и серкетного ключа вашего проекта.

Успешный ответ

Ответ должен отправляться в формате json


{"result": {
    "message": "Запрос успешно обработан"
}}

  • message – Текстовый статус выполнения запроса.

Ошибочный ответ

Ответ должен отправляться в формате json


{"result": {
    "message": "Описание ошибки"
}}

  • message – Текстовый статус выполнения запроса.

Возвращаемые ошибки

Внутреняя ошибка! Произошла ошибка при создании платежа, попробуйте попытку позже!
Возникла проблема на стороне сервиса.

Не указан идентификатор абонента в системе партнера!
Не указан параметр account при формировании запроса оплаты

Минимальная сумма оплаты 5 рублей!
Минимальная сумма для оплаты которая должна быть указана в параметре sum должна быть минимум 5 рублей.

Магазин ещё не прошел этап модерации, оплата невозможна!
Вы пытаетесь произвести оплату в магазине который еще не прошел этап модерации.

Магазин не найден, обратитесь к администрации магазина!
Неверно указан публичный ключ для оплаты. Проверьте верность отправки формы.

Запрос составлен неверно!
Общая ошибка, которая указывает что вы неверно сформировали запрос для произведения оплаты

Обработчики и CMS модули