Поля формы оплаты
Поля формы оплаты
Обратите внимание
Все текстовые поля должны быть в кодировке UTF-8.
Пример кода для формирования заказа для оплаты
<form action="https://securesandbox.webpay.by/" method="post">
<input type="hidden" name="*scart">
<input type="hidden" name="wsb_version" value="2">
<input type="hidden" name="wsb_language_id" value="russian">
<input type="hidden" name="wsb_storeid" value="11111111">
<input type="hidden" name="wsb_store" value="Название Вашего магазина">
<input type="hidden" name="wsb_order_num" value="ORDER-12345678">
<input type="hidden" name="wsb_test" value="1">
<input type="hidden" name="wsb_currency_id" value="BYN">
<input type="hidden" name="wsb_seed" value="1242649174">
<input type="hidden" name="wsb_customer_name" value="Иванов Петр Петрович">
<input type="hidden" name="wsb_customer_address" value="Минск ул. Шафарнянская д.11 оф.54">
<input type="hidden" name="wsb_service_date" value="Доставка до 1 января 2016 года">
<input type="hidden" name="wsb_return_url" value="http://yoursiteurl.com/success.php">
<input type="hidden" name="wsb_cancel_return_url" value="http://yoursiteurl.com/cancel.php">
<input type="hidden" name="wsb_notify_url" value="http://yoursiteurl.com/notify.php">
<input type="hidden" name="wsb_email" value="ivanov@test.by">
<input type="hidden" name="wsb_phone" value="375291234567">
<input type="hidden" name="wsb_invoice_item_name[0]" value="Товар 1">
<input type="hidden" name="wsb_invoice_item_quantity[0]" value="2">
<input type="hidden" name="wsb_invoice_item_price[0]" value="10">
<input type="hidden" name="wsb_invoice_item_name[1]" value="Товар 2">
<input type="hidden" name="wsb_invoice_item_quantity[1]" value="1">
<input type="hidden" name="wsb_invoice_item_price[1]" value="0.5">
<input type="hidden" name="wsb_total" value="31.40">
<!-- Значение SecretKey в примере равно 1 -->
<input type="hidden" name="wsb_signature" value="266e9c04a24dfb5fc75775c42a831a49488f8303">
<input type="hidden" name="wsb_tax" value="10.50">
<input type="hidden" name="wsb_shipping_name" value="Стоимость доставки">
<input type="hidden" name="wsb_shipping_price" value="0.98">
<input type="hidden" name="wsb_discount_name" value="Скидка на товар">
<input type="hidden" name="wsb_discount_price" value="0.58">
<input type="hidden" name="wsb_order_contract" value="Договор №152/12-1 от 12.01.19">
<input type="submit" value="Купить">
</form>Основные поля формы оплаты
| Название поля | Обязательное поле | Описание поля | Примечание |
|---|---|---|---|
*scart | да | Поле не содержит значения и обозначает тип запроса | |
wsb_storeid | да | Идентификатор магазина в системе WEBPAY. Данный идентификатор создается при регистрации в системе WEBPAY и высылается в письме | |
wsb_store | нет | Название магазина, которое будет отображаться на форме оплаты. По умолчанию берется из настроек биллинг-аккаунта | Максимальная длина поля 64 символа |
wsb_order_num | да | Уникальный идентификатор заказа, присваиваемый магазином | Максимальная длина поля 64 символа. При оплате через ЕРИП значение поля не может начинаться на 0 (ноль) |
wsb_currency_id | да | Идентификатор валюты. Буквенный трехзначный код валюты согласно ISO4271 | Допустимые значения: BYN, USD, EUR, RUB |
wsb_version | да | Версия формы оплаты | Текущий номер версии: 2 |
wsb_language_id | нет | Идентификатор языка формы оплаты | Допустимые значения: russian, english. При отсутствии значения определяется по настройкам браузера |
wsb_seed | да | Случайная последовательность символов, участвующих в формировании подписи заказа | Электронная подпись заказа |
wsb_signature | да | Контрольное значение (электронная подпись) заказа — результат выполнения функции SHA1 (для версии 2, см. поле wsb_version) либо MD5, если версия протокола не указана. Данное значение является hex-последовательностью | Электронная подпись заказа |
wsb_return_url | нет | URL адрес, на который возвращается покупатель в случае успешной оплаты, нажав на кнопку на странице с результатом оплаты. В случае, если вам необходимо установить автоматический редирект на URL адрес, то вы можете обратиться в службу поддержки WEBPAY по адресу support@webpay.by | К данному URL добавляются значения Идентификатора заказа (wsb_order_num) и номера транзакции (wsb_tid) в системе WEBPAY |
wsb_cancel_return_url | нет | URL адрес, на который возвращается покупатель в случае не успешной оплаты | К данному URL добавляются значение Идентификатора заказа (wsb_order_num) |
wsb_notify_url | нет | Данный URL вызывается вне зависимости от того, был ли переход по URL в поле wsb_return_url или нет. Основное назначение этого URL оповестить сайт об успешной оплате в случае, если пользователь не нажал кнопку "Вернуться на сайт" на форме оплаты. По умолчанию берется из настроек биллинг-аккаунта. Внимание! Отправка нотификаторов возможна только на стандартные порты: 80 (http), 443 (https), 8080 (http_alt), 8443 (pcsync-https) | Нотификатор об оплате |
wsb_test | да | Поле, указывающее на проведение тестовой оплаты.
| В тестовой среде Sandbox значение данного поля должно быть равным 1 |
wsb_3ds_payment_option | нет | Поле, позволяющее принудительно изменять необходимость прохождения 3D-Secure плательщиком. Управление 3D-Secure недоступно для магазинов, которые работают через банк-эквайер "Приорбанк" ОАО. Для подключения возможности работы с данным функционалом необходимо связаться с персональным менеджером WEBPAY | Допустимые значения:
|
wsb_customer_name | нет | Наименование получателя товара/услуги | Максимальная длина поля 255 символов |
wsb_customer_address | нет | Адрес получателя товара/услуги | Максимальная длина поля 255 символов |
wsb_service_date | нет | Сроки предоставления товаров/услуг/работ | Максимальная длина поля 255 символов |
wsb_show_wt | нет | Токен платежной сессии. Используется для восстановления платежной сессии в случае, если сценарий был прерван | Возможные значения:
https://URL_адрес_платежной_страницы/{wsb_show_wt} |
Поля для формирования корзины товаров/услуг
| Название поля | Обязательное поле | Описание поля | Примечание |
|---|---|---|---|
wsb_invoice_item_name[{n}] | да | Наименование единицы товара | Индекс {n}, должен начинаться с 0 и увеличиваться на 1 для каждой последующей позиции |
wsb_invoice_item_quantity[{n}] | да | Количество единиц товара. Целое число, обозначающее количество единиц товара каждого наименования | Индекс {n}, должен начинаться с 0 и увеличиваться на 1 для каждой последующей позиции |
wsb_invoice_item_price[{n}] | да | Цена единицы товара. Число, определяющее стоимость каждой единицы товара (BYN, USD, EUR, RUB с 2 знаками после запятой или точки) | Индекс {n}, должен начинаться с 0 и увеличиваться на 1 для каждой последующей позиции |
wsb_tax | нет | Поле, значением которого является сумма налога в белорусских рублях, добавляемая к общей сумме заказа | При оплате через ЕРИП это поле не учитывается (сумма налога добавляется к сумме единицы товара) |
wsb_shipping_name | нет | Поле определяющее наименование (способ) доставки | Максимальная длина поля 255 символов |
wsb_shipping_price | нет | Поле, значением которого является сумма доставки, добавляемая к общей сумме заказа | |
wsb_discount_name | нет | Поле с описанием скидки | Максимальная длина поля 255 символов |
wsb_discount_price | нет | Поле, значением которого является сумма скидки, вычитаемая из общей суммы заказа | Значение должно быть положительным числом (без знака "-" минус) |
wsb_discount_promo_code | нет | Поле содержит значение промокода скидки для заказа при работе со скидочными программами VISA и MASTERCARD | Максимальная длина поля 32 символа |
wsb_total | да | Данное поле является вычисляемым. Значение этого поля является общей суммой оплаты заказа. Правило вычисления общей суммы: wsb_total = wsb_invoice_item_quantity[0] * wsb_invoice_item_price[0] + wsb_invoice_item_quantity[1] * wsb_invoice_item_price[1] + ... wsb_invoice_item_quantity[n] * wsb_invoice_item_price[n] + wsb_tax + wsb_shipping_price - wsb_discount_price | Оплата не будет произведена, если wsb_total и посчитанное значение товаров не будет совпадать. Покупателю будет отображена ошибка |
Дополнительные поля
| Название поля | Обязательное поле | Описание поля | Примечание |
|---|---|---|---|
wsb_order_tag | нет | Метка заказа. Используется для отнесения заказа к определенной категории, группировки заказов или других нужд | Максимальная длина поля 64 символов |
wsb_email | нет | Электронный адрес покупателя | Значение данного поле будет автоматически подставлено в соответствующее поле формы оплаты |
wsb_phone | нет | Номер телефона покупателя | |
wsb_order_contract | нет | Номер договора с заказчиком услуги/плательщиком | |
wsb_tab | нет | Определение активной вкладки с нужным платежным инструментом (оплата картой/ЕРИП) | Возможные значения: erip, cardPayment. При отсутствии поля порядок вкладок стандартный — оплата картой, потом ЕРИП |
wsb_card_number_short | нет | Определение возможности осуществления оплаты указанной плательщиком карты. Системой WEBPAY производится сверка данных номера карты (первые 6 и последние 4 цифры) между переданным номером карты в данном поле и тем, что ввел плательщик при оплате. Если первые 6 и последние 4 цифры номера карты совпадают, то оплата разрешается, иначе попытка оплаты откланяется и плательщику выводится ошибка | Значением является целое число, которое состоит из первых 6 и последних 4 цифр номера карты. Например: 1234561234. |
wsb_card_halva | нет | Определение принадлежности карты плательщика к карте рассрочки "Халва" ЗАО "МТБанк" и возможность осуществления оплаты данной картой. Данное поле не влияет на прохождение оплаты картами, отличными от карт рассрочки "Халва" ЗАО "МТБанк" | Возможные значения:
|