Протокол уведомлений Pokupo - Платежное АПИ, API

Если вы уже разрабатывали прием платежей через WebMoney или Z-Payment, то для подключения вашего магазина к системе Pokupo вам достаточно настроить его параметры и внести незначительные поправки в HTML коды.

Параметры магазина Pokupo

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

Форма запроса платежа

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

Адрес мерчанта:

• https://seller.pokupo.ru/api/ru/payment/merchant — русскоязычный мерчант
• https://seller.pokupo.ru/api/en/payment/merchant — англоязычный мерчант

Поля, одидаемые на мерчант от продавца описаны в таблице ниже:

Параметры, отправляемые при предварительном запросе

Следующие данные передаются на URL уведомлений непосредственно перед выполнением платежа если установлен соответствующий флаг в настройках магазина:

Параметры, отправляемые при оповещении о платеже на URL уведомлений магазина:

В ответ на оповещение о платеже ваш сайт должен вернуть HTTP заголовок с кодом «200 OK» и строку YES, иначе оповещение о выполненном платеже будет повторяться в пределах 24 часов.

Внимание!

Название передаваемого поля > Сайт магазина обязательно должен предусмотреть проверку информации, присланной в «Форме оповещения о платеже» в соответствии с рекомендациями раздела «Алгоритм формирования и проверки контрольной подписи».

Параметры, передаваемые на LMI_SUCCESS_URL

Данные параметры передаются на указанный адрес в случае успешной оплаты счета

Параметры, передаваемые на LMI_FAIL_URL

Данные параметры передаются на указанный адрес в случае неуспешной оплаты счета

Проверка информации

При выполнении платежа Pokupo высылает оповещение о платеже на URL уведомлений, указанный продавцом в настройках магазина. Мы рекомендуем вам проверить полученные уведомления:

1. Проверить, действительно ли данные переданы от сервиса Pokupo (Проверка источника данных)
2. Проверить, не исказились ли данные в процессе передачи (с помощью проверки хэша)
3. Проверить сумму платежа
4. Проверить ID магазина

Если URL уведомлений обеспечивает секретность и не переопределяется и если продавец не желает проверять контрольную подпись, он должен установить флаг «Отправлять пароль уведомления». В этом случае Pokupo будет высылать Пароль уведомления на веб-сервер продавца в поле «LMI_SECRET_KEY» при отправке уведомлений об оплате. Продавец должен проверять его каждый раз, когда получает оповещение о выполнении платежа.

Проверка подписи является более трудоемким методом, но он не требует передачи Merchant Key через интернет и является более безопасной.

Контрольная подпись данных о платеже

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

При формировании контрольной подписи сервис Pokupo «склеивает» значения полей, передаваемых «Формой оповещения о платеже», в одну строку в следующем порядке:

• ID магазинадля CMS (LMI_PAYEE_PURSE);
• Сумма платежа (LMI_PAYMENT_AMOUNT);
• Внутренний номер покупки продавца (LMI_PAYMENT_NO);
• Флаг тестового режима (LMI_MODE);
• Внутренний номер счета ввыбранной платежной системе (LMI_SYS_INVS_NO);
• Внутренний номер платежа в системе Pokupo (LMI_SYS_TRANS_NO);
• Дата и время выполнения платежа (LMI_SYS_TRANS_DATE);
• Пароль уведомлений продавца;
• E-mail покупателя (LMI_PAYER_PURSE);
• E-mail покупателя (LMI_PAYER_WM).

Формируется последовательность из 32-х шестнадцатеричных цифр в соответствии с широко распространенным алгоритмом Message Digest 5 (MD5). Контрольная подпись LMI_HASH передается в верхнем регистре (заглавными буквами).

Проверка контрольной подписи

Проверка контрольной подписи выполняется на сайте продавца по следующему алгоритму:

1. Сформируйте строку путем «склеивания» значений параметров, полученных на URL уведомлений, в том же порядке, что и при формировании контрольной подписи в сервисе Pokupo (см. выше).
2. Вычислите MD5 полученной строки.
3. Преобразуйте строку в верхний регистр
4. Сравните полученное значение с значением параметра «LMI_HASH», полученного через «Форму оповещения о платеже».

Проверка суммы платежа

Несмотря на то, что покупатель не может изменить сумму платежа, продавцу рекомендуется контролировать информацию о сумме платежа, передаваемую через параметр «LMI_PAYMENT_AMOUNT».

Проверка ID магазина

Несмотря на то, что покупатель не может изменить ID магазина, для которого совершается платеж, продавцу рекомендуется контролировать информацию о ID магазина, которая передается через параметр «LMI_PAYEE_PURSE», особенно при использовании нескольких магазинов при работе с Pokupo.