Промокоды для программ VISA и MASTERCARD

Описание скидочной программы VISA/MASTERCARD

Механизм предназначен для совершения платежей по заказам поставщика услуг, который участвует в скидочной программе платежной системы VISA/MASTERCARD. Данная программа предусматривает предоставление скидки по заказу, если оплата будет совершена с использованием любой карты VISA/MASTERCARD. Также предусмотрена возможность участия в скидочных программах VISA при оплате премиальными типами карт. Плательщик на стороне поставщика услуг выражает свое желание об оплате заказа с использованием одной из премиальных карт. Компания WEBPAY контролирует, чтобы оплата была произведена указанным типом карты.

Описание механизма работы с промокодом VISA и MASTERCARD:

Плательщик на стороне поставщика услуг выражает свое желание об оплате заказа с использованием любой карты платежной системы VISA/MASTERCARD либо премиальной картой VISA. Компания WEBPAY контролирует, чтобы оплата была произведена указанной платежной системой либо указанным типом премиальной карты VISA.
В соответствии с выбранным типом платежной системы поставщик услуг определяет значение скидки и промокода. Сумма скидки передается в поле wsb_discount_price (Поля для формирования корзины товаров/услуг) и должна учитываться при расчете общей суммы заказа. Так же можно передать текст для описания скидки в поле wsb_discount_name. При работе с JSON API используйте следующий запрос.
Если значение промокода передано и поставщик услуг участвует в скидочной программе VISA или MASTERCARD, то система WEBPAY проверяет карту плательщика на соответствие промокоду. Если найдено расхождение, то происходит запрет на проведение платежа.

Значения возможных промокодов для карт VISA/MASTERCARD, которые передаются в поле wsb_discount_promo_code, указаны в таблице ниже:

Тип карты	Значение промокода
VISA	visa
MASTERCARD (не входят карты MAESTRO и БЕЛКАРТ-MAESTRO)	mastercard

Значения возможных промокодов для премиальных карт VISA, которые передаются в поле wsb_discount_promo_code, указаны в таблице ниже:

Тип карты	Значение промокода
VISA Gold	gold
VISA Platinum	platinum
VISA Infinite	infinite

Например, если выбрана оплата по премиальной карте VISA Gold, авторизационный запрос будет выглядеть следующим образом.

Инфо

Регистр промокода в данном случае значения не имеет. Если разрешено совершить платеж без выбора типа карты, то поле wsb_discount_promo_code можно не передавать или оставить пустым.

<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="0">
  <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="bc8ea3bee19c247d090c79c8bbb7974f9484db96">
  <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="hidden" name="wsb_discount_promo_code" value="gold">
  <input type="submit" value="Купить">
</form>

Тестирование скидочной программы VISA/MASTERCARD

Процесс выполнения тестовых запросов на оплату аналогичен описанному в JSON API либо в разделе Формирование заказа для оплаты за некоторым исключением:

Необходимо обратиться в техническую поддержку WEBPAY support@webpay.by для включения для вашей учетной записи возможности работы по скидочной программе VISA/MASTERCARD.
Для того, чтобы в тестовой среде был доступен ввод разных номеров карт, необходимо параметр wsb_test передать со значением 0.
При тестировании можно указывать любые 16-значные номера карт VISA или MASTERCARD. Создать набор таких карт можно с помощью открытых ресурсов по генерации номеров банковских карт. При генерации номеров премиальных карт используйте следующие первые 6 цифр карты (BIN карты):

Тип карты	BIN карты
VISA Gold	480066
VISA Platinum	417685
VISA Infinite	455674