Быстрое подключение

Вернуться на страницу "Быстрое подключение"


4. Запрос на оплату заказа. Форма оплаты на сайте интернет-магазина
 

Платёжный сервис Uniteller узнаёт о необходимости обработать оплату товара или услуги из запроса оплаты заказа, отправленного с сайта вашего интернет-магазина. Это общеизвестный в Интернете POST запрос, который направляется на специальный адрес нашего сервера (https://wpay.uniteller.ru/pay/) и содержит обязательную, а возможно и дополнительную информацию, необходимую для проведения платежа.

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

Пример шаблона HTML-формы оплаты: 

<form action="https://wpay.uniteller.ru/pay/" method="POST "> 
<input type="hidden" name="Shop_IDP" value="Ваш Shop_ID"> 
<input type="hidden" name="Order_IDP" value="Ваш Order_ID"> 
<input type="hidden" name="Subtotal_P" value="Сумма платежа"> 
<input type="hidden" name="Lifetime" value="Время жизни формы"> 
<input type="hidden" name="Signature" value="Подпись платежа"> 
<input type="submit" name="Submit" value="Оплатить"> 
<input type="hidden" name="URL_RETURN_OK" value="http://example.com/pay/ok/"> 
<input type="hidden" name="URL_RETURN_NO" value="http://example.com/pay/fail/"> 
<input type="hidden" name="MeanType" value="0"> 
<input type="hidden" name="EMoneyType" value="0"> 
</form>

 

Important

Кодировка символов на странице с размещённой формой и самого содержимого полей формы должна быть UTF-8.

Форма оплаты может содержать как обязательные, так и необязательные параметры. Обязательными (а зачастую и достаточными) параметрами являются только указанные в табл. 1. В табл. 2 для краткости перечислена только часть возможных необязательных параметров. Полный их список с подробными пояснениями приведён в документе «Технический порядок. Интернет эквайринг».

Табл. 1 — Обязательные параметры формы оплаты на сайте интернет-магазина

Параметр

Описание

1

Shop_IDP

Идентификатор точки продажи (интернет-магазина) в системе Uniteller.

В Личном кабинете этот параметр называется Uniteller Point ID и его значение доступно на странице «Точки продажи компании» (пункт меню «Точки продажи») в столбце Uniteller Point ID.

2

Order_IDP

Номер заказа в системе расчётов интернет-магазина, соответствующий данному платежу. Может быть любой непустой строкой максимальной длиной 127 символов, не может содержать только пробелы.

3

Subtotal_P

Сумма покупки в валюте, оговоренной в договоре с банком-эквайером. В качестве десятичного разделителя используется точка, не более 2 знаков после разделителя. Например, 12.34.

4

Signature

Подпись формы оплаты, гарантирующая неизменность критичных данных оплаты (суммы, Order_IDP). Параметр Signature рассчитывается при помощи хеш-функции md5 от значений самых ключевых параметров, которые могут быть включены в запрос оплаты. Обращаем ваше внимание на то, что правильный подсчёт значения параметра Signature абсолютно необходим для проведения оплаты.

Signature вычисляется по следующему алгоритму:

Signature = uppercase(md5(md5(Shop_IDP) + & + md5(Order_IDP) + & + md5(Subtotal_P) + & + md5(MeanType) +& + md5(EMoneyType) + & + md5(Lifetime) + & + md5(Customer_IDP) + & + md5(Card_IDP) + & + md5(IData) +& + md5(PT_Code) + & + md5(password)))

где:

• password — пароль из раздела «Параметры Авторизации» Личного кабинета системы Uniteller.

• '+' — операция конкатенации текстовых строк (все строки преобразуются в байты в кодировке ASCII).

• '&' — символ «разделитель полей». Если необязательный параметр не передаётся в форме, соответствующий этому полю (следующий за ним) знак '&' сохраняется в строке для вычисления Signature.

• md5 — криптографическая хеш-функция (символы в нижнем регистре). При реализации подсчёта md5 вам может помочь форма, размещённая в Интернете по адресу: http://www.adamek.biz/md5-generator.php.

• uppercase — функция приведения к верхнему регистру.

• MeanType — платёжная система банковской карты. Если MeanType не передаётся в форме, то следует его принять пустой строкой. В этом случае в последовательность подставляется значение md5 от пустой строки, равное d41d8cd98f00b204e9800998ecf8427e.

• EMoneyType — тип электронной валюты. Если EMoneyType не передаётся в форме, то следует его принять пустой строкой. В этом случае в последовательность подставляется значение md5 от пустой строки, равное d41d8cd98f00b204e9800998ecf8427e.

• Lifetime — время жизни формы оплаты в секундах. Если Lifetime не передаётся в форме, то следует его принять пустой строкой. В этом случае в последовательность подставляется значение md5 от пустой строки, равное d41d8cd98f00b204e9800998ecf8427e.

• Customer_IDP — идентификатор покупателя, используемый некоторыми интернет-магазинами. Если Customer_IDP не передаётся в форме, то следует его принять пустой строкой. В этом случае в последовательность подставляется значение md5 от пустой строки, равное d41d8cd98f00b204e9800998ecf8427e.

• Card_IDP — идентификатор зарегистрированной карты. Если Card_IDP не передаётся в форме, то следует его принять пустой строкой. В этом случае в последовательность подставляется значение md5 от пустой строки, равное d41d8cd98f00b204e9800998ecf8427e.

• IData — «длинная запись». Если IData не передаётся в форме, то следует его принять пустой строкой. В этом случае в последовательность подставляется значение md5 от пустой строки, равное d41d8cd98f00b204e9800998ecf8427e.

• PT_Code – тип платежа. Если PT_Code не передается в форме, то следует его принять пустой строкой. В этом случае в последовательность подставляется значение md5 от пустой строки, равное d41d8cd98f00b204e9800998ecf8427e.

5

Параметр URL_RETURN или два параметра:

URL_RETURN_OK
URL_RETURN_NO 

URL_RETURN   — URL страницы, на которую должен вернуться Покупатель после осуществления платежа в системе Uniteller. Длина до 255 символов.

URL_RETURN_OK (см. Примечание внизу таблицы) — URL страницы, на которую должен вернуться Покупатель после успешного осуществления платежа в системе Uniteller. Если этот параметр задан, то он является более приоритетным, чем параметр URL_RETURN. Длина до 255 символов.

URL_RETURN_NO (см. Примечание внизу таблицы) — URL страницы, на которую должен вернуться Покупатель после неуспешного осуществления платежа в системе Uniteller. Если этот параметр задан, то он является более приоритетным, чем параметр URL_RETURN. Длина до 255 символов.


Примечание:
Не допускается частичное кодирование спецсимволов в тексте URL. Адрес должен задаваться или полностью в некодированном виде (например, https://domen.ru/account/shopnumber/), или полностью в кодированном виде (http%3A%2F%2Fdomen.ru%2Faccount%2Fshopnumber%2F)

Табл. 2 — Необязательные параметры формы оплаты на сайте интернет-магазина

Параметр

Описание

1 Lifetime

Время жизни формы оплаты в секундах, начиная с момента её показа.

Должно быть целым положительным числом. Если Покупатель использует форму дольше указанного времени, то форма оплаты будет считаться устаревшей, и платёж не будет принят. Покупателю в этом случае будет предложено вернуться на сайт Мёрчанта для повторного выполнения заказа. 

2 BillLifetime Срок жизни заказа оплаты в электронной платёжной системе в часах (от 1 до 1080 часов). Значение параметра BillLifetime учитывается только для QIWI-платежей. Если BillLifetime не передаётся, то для QIWI-платежа срок жизни заказа на оплату устанавливается по умолчанию — 72 часа.
3

Language
(2 символа)

Код языка интерфейса платёжной страницы. Может быть en или ru.

4

Comment
(до 1024 символов)

Комментарий к платежу.

 

Important

См. «Пример PHP-кода на странице оплаты мерчанта» на странице Примечение. Примеры PHP-кода.

 


Вернуться к Разделу 3. Что нужно, чтобы подключить ваш интернет-магазин к сервису Uniteller?

Перейти к Разделу 5.Страница оплаты Uniteller

01/12/2016
Компания Uniteller поддержала новую бесконтактную технологию
расчета по картам «Мир»
 Подробности

03/11/2016
U-ON.Travel и Uniteller: лучшее решение для турбизнеса. Подробности

Uniteller в социальных сетях: