Что такое веб пэй
WebPay. Настройка
При необходимости Вы можете настроить данную систему в своем магазине. Для этого Вам сперва необходимо зарегистрироваться в системе «WebPay».
Рассмотрим алгоритм подключения шлюза подробнее.
Обратите внимание!
Шаг 1
Перейдите в личный кабинет продавца к разделу настроек на вкладке «Компания Инфо».
Обратите внимание!
Шаг 2
В открывшемся окне скопируйте значение строки «Имя биллинга».
И вставьте скопированное значение на стороне системы управления в поле «MERCHANT_NAME».
Шаг 3
Скопируйте значение строки «Биллинг ID».
И вставьте скопированное значение на стороне системы управления в поле «Merchant ID/Идентификатор магазина«.
Шаг 4
Укажите «Секретный ключ».
И указанный код введите в системе управления в поле «Секретный ключ».
Шаг 5
Укажите значение «Версия сервера Webpay«.
Данная настройка обусловлена некоторыми особенностями работы платежного шлюза: часть клиентов обслуживаются 1 сервером (чаще всего это клиенты, давно пользующиеся услугами шлюза), а часть сервером 2 (новые клиенты).
Шаг 6
Укажите используемый язык.
Шаг 6
Шаг 8
Параметр «Тестовый режим» служит для тестирования платежной системы. Если желаете протестировать платежную систему, то в выпадающем меню «Тестовый режим» выберите «Да». Если же необходимо использовать настоящие денежные операции, то выберите «Нет».
Шаг 9
Шаг 10
При необходимости Вы можете выбрать из предложенного списка иконок платежных систем соответствующую.
Для этого просто отметьте в блоке “Значки платежной системы” ту иконку, которая соответствует выбранной платежной системе.
Если в иконке нет необходимости, просто оставьте все значки невыделенными.
Шаг 11
Если Вы хотите возместить процент, взымаемый с Вас платежной системой, Вам необходимо в соответствующем поле указать размер процента для платежей, проводимых черsq способ оплаты. Этот процент при оплате будет начислен сверху к стоимости заказа.
Шаг 12
После произведенных настроек измените статус платежной системы на » Включено «.
Шаг 13
И сохраните изменения на стороне системы управления.
Шаг 14
На стороне ситсемы управления заполните все прочие обязательные поля (подробные инструкции по их заполнению Вы можете получить у представителей платежного шлюза) и нажмите «Подтвердить».
Подключение метода оплаты Webpay
В данной статье мы рассмотрим подключение платёжного модуля WEBPAY к вашему интернет-магазину на Advantshop.
Подключение WEBPAY возможно только для юридических лиц и индивидуальных предпринимателей Республики Беларусь.
Регистрация и настройки на стороне платёжной системы
В качестве первого шага вам необходимо отправить заявку на подключение в сервис WEBPAY. Перейдите по ссылке https://webpay.by/ru/ и нажмите кнопку «Заявка на подключение» (рис. 1).
Рисунок 1.
На открывшейся странице установите галочки «Интернет-эквайринг» и «Сайт» (рис. 2) и заполните ваши контактные данные (рис. 3). Затем нажмите кнопку «Отправить».
Рисунок 2.
Рисунок 3.
После успешной обработки заявки сервисом WEBPAY вы получите письмо на электронную почту (указанную вами на предыдущем шаге), которое будет содержать, в том числе, следующую информацию:
Перейдите по ссылке https://billing.webpay.by/ и введите в поля авторизации вышеуказанные имя пользователя и пароль. Нажмите кнопку «Войти» (рис. 4).
Рисунок 4.
В случае успешной авторизации в левой части страницы откроется главное меню личного кабинета WEBPAY, выполненное по принципу раскрывающегося списка (рис. 5).
Рисунок 5.
Вам необходимо проверить основные параметры. Для этого перейдите на страницу «Профайл» и обратите внимание на обязательные поля (рис. 6). Часть данных будет уже заполнена и недоступна для редактирования. Убедитесь, что установленные значения соответствуют тем, которые были согласованы с сотрудником компании WEBPAY на стадии подключения.
Рисунок 6.
Обязательно сохраните данный секретный ключ в текстовый документ на своём компьютере.
Про заполнение поля «URL для уведомлений» будет указано чуть ниже.
Рисунок 7.
Настройка на стороне интернет-магазина
Рисунок 8.
Рисунок 9.
Введите параметры, ранее полученные на стороне WEBPAY, в соответствующие поля (рис. 10).
Рисунок 10.
Для того, чтобы при оплате заказа через WEBPAY статус заказа в магазине автоматически менялся на «Оплачен», необходимо произвести ещё одну настройку на стороне сервиса.
Вернитесь в личный кабинет WEBPAY, в раздел «Настройки». В поле «URL для уведомлений» укажите ссылку «URL обработки оповещений об оплате (Notification URL)» из настроек метода оплаты в магазине (рис. 11). Сохраните настройки.
Рисунок 11.
На этом шаге настройки завершены.
Проверка работоспособности метода оплаты
Для проверки платежей через настроенный метод оплаты необходимо установить галочку «Тестовый режим» в настройках метода (рис. 12).
Рисунок 12.
Рисунок 13.
При нажатии на кнопку «Оплатить» (после ввода произвольных данных) тестовая транзакция будет проведена.
Готово. Мы рассмотрели подключение платёжного модуля WEBPAY к вашему интернет-магазину на Advantshop.
Что такое веб пэй
18 лет на сайте
пользователь #14638
Наткнулся в субботу на рекламу сервиса E-pay.
Данный платежный ресурс e-PAY™ является совместным проектом ООО «Веб Пэй» и «Приорбанк» ОАО и не имеет аналогов на белорусском рынке. ООО «Веб Пэй» является разработчиком белорусской биллинговой системы электронных платежей WEBPAY™, предоставляющей услуги по обслуживанию финансовых операций, совершаемых посредством пластиковых карточек в сети Интернет.
Наш платежный ресурс предоставляет возможности для быстрой и удобной оплаты клиентами коммунальных услуг, а также гарантирует поступление финансовых средств на счет поставщика услуг в полном объеме. Мы сотрудничаем с операторами мобильной связи, предприятиями жилищно-коммунального комплекса, операторами эфирно-кабельного телевидения и другими организациями.
Основными целями ООО «Веб Пэй» являются:
— популяризация интернет-платежей посредством ресурса e-PAY™ и системы электронных платежей WEBPAY™ среди населения;
— укрепление системы электронных платежей WEBPAY™, как ведущей системы в секторе электронных платежей в режиме реального времени;
— достижение доминирующего положения системы электронных платежей WEBPAY™ на рынке Беларуси.
Решил испытать все на себе, тем более, что на счете ByFly предоплата уже подходила к концу и требовалось пополнение счета.
Счет был пополнен в субботу (в первой половине дня), по отчету системы: «Платеж завершен успешно» (деньги с пластиковой карточки тоже списались).
Какого же было мое удивление утром в воскресенье, когда оказалось, что денег на счет ByFly так и не поступило.
Учитывая, что в выходной день явно правды ни у кого не добьешься и саппорт беспокоить бесполезно, в понедельник отправил письмо по адресу, указанному в качестве службы поддержки.
. Во второй половине дня в понедельник, устав ждать ответа на свое письмо (которое, кстати, содержало реквизиты платежа) я направил повторное сообщение в службу поддержки (на этот раз через форму обратной связи на сайте).
В результате чего, о чудо, был получен ответ из службы поддержки ( support@webpay.by )
По техническим причинам от нас не зависящим, зачисление платежей по услуге BYFLY не производилось.
Сумма платежа возвращена Вам на счет.
Приносим Вам свои извинения за причененные неудобства.»
Стоит сказать, что на главной странице сервиса отдельно выделено (наверное, как какие-то особые преимущества сервиса):
1. Экономить Ваше время и силы, которые вы тратите на оплату услуг и сервисов.
2. Оплачивать счета в удобное для вас время, не ограничиваясь расписанием работы и расположением пунктов приема платежей.
3. Обширный список услуг, которые можно оплатить круглосуточно.
Так что, рекомендую очень хорошо подумать, используя этот «сервис» для каких-нибудь важных платежей (например, погашение кредита и проч.)
Как подключить прием платежей через WEBPAY?
Интернет-магазины, созданные на платформе beseller, имеют возможность принимать дистанционные платежи по картам Visa, MasterCard, Белкарт, Халва, через сервис ЕРИП (АИС «Расчет») при помощи провайдера электронных платежей WEBPAY.
Модуль приема дистанционных платежей WEBPAY подключается менеджером платформы beseller.by по запросу администратора магазина.
Для работы модуля необходимо предварительно заключить договор с ООО «ВЕБ ПЭЙ».
Настройка приема платежей осуществляется в модуле «Корзина» панели управления сайтом.
На вкладке «Данные от покупателя»:
Вы создали новый способ платежа.
Далее необходимо указать при каких способах доставки покупатель имеет возможность проводить оплату по картам или через ЕРИП.
Настройка приема платежей WEBPAY закончена.
При оформлении заказа через корзину покупатель может выбрать оплату по картам.
При необходимости, ваш персональный менеджер окажет вам необходимые консультацию и поможет настроить модуль приема платежей.
Смотрите также руководства:
Общие сведения
Данное руководство описывает процесс разработки платежного модуля для приема платежей в сети Интернет c помощью системы WEBPAY и использование тестовой среды (Sandbox) для тестирования разрабатываемого модуля.
Порядок разработки
Интерфейс Web-приложения
Интерфейс Web-приложения тестовой системы Sandbox и реальной системы не отличаются. Обращаем Ваше внимание на адрес, используемой среды в браузере (для тестовой среды — https://sandbox.webpay.by, для реальной — https://billing.webpay.by). Перед началом разработки рекомендуется зайти в Web-приложение и ознакомиться с его содержимым (Личный кабинет).
Основной экран приложения
После входа в Web-приложение Вам будет отображена следующая страница:
На данной странице отображается основная статистика по Вашему биллинг-аккаунту, тут же Вы сможете сформировать статистику за выбранный интервал времени. Слева находится панель навигации, которая предоставляет возможность управления Вашим аккаунтом, а также требуемой информацией по прошедшим транзакциям.
Установка секретного ключа
Секретный ключ необходим для формирования электронной подписи каждого Вашего платежа (Электронная подпись заказа). Этот параметр является обязательным к заполнению и без него невозможно будет проведение транзакций по оплате товаров/услуг. Для установки значения ключа необходимо заполнить поле SecretKey. Для этого необходимо перейти к разделу меню «Настройки» → «Компания». Это поле может содержать случайную последовательность символов за исключение знака &.
Просмотр финансовых операций
Для просмотра всех финансовых операций необходимо воспользоваться пунктом меню «Платежи». На данной странице отображены все финансовые платежи (транзакции), осуществленные банковской картой онлайн.
Каждая такая транзакция привязана к Инвойсу (Счету), у инвойса может быть несколько типов транзакций, таких как:
В поле «ID счета» содержится номер, к которому привязаны транзакции. Для просмотра всех транзакций, связанных с этим номером, а также значений, с которыми был совершен платеж, необходимо нажать на ссылку. В результате Вы перейдете на страницу с информацией о данном инвойсе.
Вход в персональный кабинет WEBPAY
Доступ в личный кабинет WEBPAY осуществляется посредством интернет-браузера по защищенному каналу связи.
Для входа в персональный кабинет WEBPAY необходимо указать следующий адрес:
В открывшемся окне следует указать предоставленные персональным менеджером компании WEBPAY логин и пароль.
Важно!
Обращаем Ваше внимание, что соединение должно быть защищенным, поэтому обязательно укажите https вместо http.
В случае успешной авторизации вы попадете на страницу панели мониторинга. Панель мониторинга условно разделена на пять блоков:
В левой части экрана располагается скрывающееся меню, из которого можно попасть в разделы «Счета», «Платежи», «Журнал платежей», «Отчеты» и «Настройки».
Заполнение параметров персонального кабинета WEBPAY («Компания»)
Перед началом работы необходимо проверить основные параметры Вашего биллинг-аккаунта. Для этого необходимо перейти в пункт меню «Настройки» → «Компания». В данном разделе Вы можете изменить данные о Вашей организации (адрес компании, город, почтовый индекс, контактный телефон). Также в данном разделе Вы можете произвести следующие настройки:
Для изменения остальных данных (имя компании, наименование юридического лица, сайт компании) Вам необходимо связаться с персональным менеджером WEBPAY.
Создание учетной записи («Учетные записи»)
В открытом личном кабинете перейдите в пункт меню «Настройки» → «Пользователи». В данном разделе можно создавать, удалять и управлять учетными записями пользователей Вашей компании, которые имеют доступ к системе WEBPAY.
Для создания нового пользователя необходимо нажать кнопку «Добавить пользователя» в меню «Настройки» → «Пользователи».
Перед Вами откроется форма, в которой нужно указать следующие обязательные параметры:
Также следует указать, какими правами должен обладать владелец создаваемой учетной записи в списке «Группы»:
Если Вы хотите, чтобы создаваемая учетная запись имела права и возможности создавать счета и пользователей и редактировать данные по ним, необходимо выбрать из выпадающего списка группы «Администратор».
Для завершения создания новой учетной записи нажмите кнопку «Подтвердить».
Также Вы можете создать учетные записи для Ваших постоянных клиентов. Для этого необходимо выбрать из выпадающего списка группы «Покупатель». Тогда Вы можете выставлять счет данному покупателю, выбрав его из списка.
В меню «Пользователи» Вы всегда можете просмотреть уже созданные учетные записи или перейти к их редактированию. Для редактирования учетной записи нужно щелкнуть по интересующей записи и нажать кнопку «Изменить пользователя» в верхнем правом углу экрана.
Просмотр информации о платежах
Все платежи, которые поступили в пользу Вашей компании при оплате банковской картой онлайн, Вы можете просматривать в меню «Платежи».
Для удобства поиска и работы с информацией в списке «Платежи» и «Журнал платежей» можно произвести поиск платежей по интересующим Вас параметрам. Для этого следует воспользоваться окном сверху от списка. Окно можно раскрыть, получив расширенные опции поиска. По умолчанию используется сортировка по дате платежа. Поиск можно осуществить по следующим параметрам:
Все счета, которые были выставлены Вашей компанией, включая оплаченные, Вы можете просматривать в меню «Счета». В списке доступна следующая информация:
При нажатии на счет раскрывается дополнительная информация:
Журнал платежей
Все попытки оплаты, осуществленные по банковской карте, включая не успешные, с указанием текстовой информации о результате проведения операции отображаются в меню «Журнал платежей». В списке доступна следующая информация:
Если кликнуть на поле «ID транзакции», то откроется окно «Журнал операций по платежу». Также здесь можно найти ссылку на чек, который получил плательщик после успешной оплаты.
Отчетность по совершенным платежам
Для получения отчетов по платежам, совершенным через АИС «Расчет» (ЕРИП) и/или интернет-эквайринг, и результатов сверки поступления средств Вам необходимо зайти в систему отчетности по адресу https://merchant-sandbox.webpay.by для тестовой среды и по адресу https://merchant.webpay.by для реальной среды. Логин и пароль тот же, что и для входа в персональный кабинет WEBPAY.
Отчеты из этого кабинета Вы можете экспортировать в Excel. Также можно, не заходя в систему отчетности, получать отчеты на email в Excel-файле или в формате JSON.
Отчетность по транзакциям, совершенным через АИС «Расчет» (ЕРИП)
Выберите пункт меню «ЕРИП» → «Результаты платежей». В итоге отобразится отчет, который содержит результат оплаты заказа и информацию о перечислении средств. Запись в отчете появляется сразу же после оплаты. Позднее, по факту формирования АИС «Расчет» (ЕРИП) реестров, добавляется информация из данных реестров о перечислении средств. Автоматически проводится сверка и выставляется успешный или не успешный статус сверки.
Описание полей
Результат выполнения платежа. Возможные значения:
Успешный платеж — система WEBPAY подтвердила успешное выполнение платежа.
Сбой платежа — система WEBPAY не подтвердила успешное выполнение платежа.
Не подтверждено WEBPAY — отчет сверки ЕРИП содержит информацию по несуществующей операции.
Статус сверки данных WEBPAY с данными из отчетов ЕРИП. Возможные значения:
Не подтверждено банком (ЕРИП) — для успешной транзакции в системе WEBPAY не пришло подтверждение из ЕРИП.
Успешная сверка — для успешной транзакции в системе WEBPAY пришло подтверждение из ЕРИП.
Ошибка сверки — для успешной транзакции в системе WEBPAY пришло подтверждение из ЕРИП, но существует несоответствие в параметрах платежа.
Способ платежа. Возможные значения:
MS — карточка с магнитной полосой.
BC — карточка БЕЛКАРТ.
NONE — плательщик не идентифицирован.
CASH — оплата наличными в РКЦ.
CASHIN — оплата наличными в платежно-справочном терминале.
Чтобы просмотреть все транзакции АИС «Расчет» ЕРИП, необходимо выбрать пункт меню «ЕРИП» → «Журнал транзакций». В результате отобразится отчет, который содержит информацию об этапах оплаты заказа и возврате средств в режиме реального времени. Оплата производится в три этапа:
Возврат средств производится в два этапа:
Описание полей отчета
| Название | Описание |
|---|---|
| ID запроса | Единый идентификатор последовательности запросов на оплату в ЕРИП. |
| Статус операции | |
| Дата запроса | Дата формирования запроса в ЕРИП. |
| ID транзакции ЕРИП | Учетный номер операции в центральном узле ЕРИП. |
| ID транзакции WEBPAY | Идентификатор ЕРИП в рамках платежных запросов. |
| Лицевой счет WEBPAY | Значение, идентифицирующее потребителя услуг или товар. |
| Номер услуги | Номер услуги Магазина. |
| Сумма | Сумма платежа в системе WEBPAY. |
| Валюта | Валюта платежа в системе WEBPAY. |
| Тип авторизации | Тип авторизации средств при оплате заказа. |
| Расчетный агент | Код расчетного агента. |
Отчетность по транзакциям, совершенным через интернет-эквайринг
Выберите пункт меню «Платежи» → «Отчет сверки». В итоге отобразится отчет, который содержит результат оплаты заказа и информацию о сверке оплаты с банком-эквайером. Запись в отчете появляется сразу же после оплаты.
Описание полей отчета:
Результат выполнения платежа. Возможные значения:
Авторизация — денежные средства заблокированы на карте плательщика.
Сброс авторизации — денежные средства разблокированы на карте плательщика.
Частичный сброс авторизации — часть денежных средств разблокирована на карте плательщика.
Финансовое завершение — денежные средства списаны со счета плательщика.
Полный возврат средств — денежные средства списаны с р/с Магазина и возвращены на карту плательщика.
Частичный возврат средств — часть денежных средств списано с р/с Магазина и возвращена на карту плательщика.
Статус сверки данных WEBPAY с данными из отчетов банка. Возможные значения:
Не подтверждено банком — для успешной транзакции в системе WEBPAY не пришло подтверждение из банка.
Успешная сверка — для успешной транзакции в системе WEBPAY пришло подтверждение из банка.
Ошибка сверки — для успешной транзакции в системе WEBPAY пришло подтверждение из банка, но существует несоответствие в параметрах платежа.
В случае если Вашим банком-эквайером является «Приорбанк» ОАО, ЗАО «МТБанк», ОАО «Дабрабыт» Вы можете воспользоваться пунктом меню «Платежи» → «Поступление средств», чтобы просмотреть информацию об отражении денежных средств в банке-эквайере. В результате отобразится отчет, который содержит информацию об успешных транзакциях, отраженных в банке.
Описание полей отчета
| Название | Описание |
|---|---|
| Дата учета платежа/возврата в банке | Дата отражения денежных средств в банке-эквайере. |
| Сумма к перечислению | Сумма за вычетом комиссии, которая поступит на р/с Магазина. |
| Валюта перечисления | Валюта, в которой зачисляются денежные средства. |
| Номер заказа торговца | Уникальный идентификатор заказа, присваиваемый Магазином. |
| Номер терминала | Номер терминала, установленный банком-эквайером. |
| ID мерчанта | Идентификатор магазина в системе WEBPAY. |
| Сайт торговца | Сайт, подключенный к системе WEBPAY. |
| Номер заказа WEBPAY | Номер заказа в системе WEBPAY. |
| Код авторизации банка-эмитента | Код авторизации, присвоенный банком-эмитентом. |
| RRN | Уникальный номер транзакции, присваиваемый процессинговым центром. |
| Сумма возмещения | Сумма платежа в системе WEBPAY. |
| Комиссия возмещения | Комиссионное вознаграждение банку. |
| Дата и время авторизации | Дата совершения платежа в системе WEBPAY. |
Расширенные настройки платежной страницы
Важно!
Для внесения изменений в оформление платежной страницы, необходимо обратиться к менеджеру компании WEBPAY по адресу managers@webpay.by
Логотип должен быть в формате png. Максимальная высота изображения 100px (пикселей), а размер не более 500 KB. Рекомендуем использовать прозрачный фон.
Цвет передается в шестнадцатеричном коде — Hex Code (значение цвета представлено в виде «#XYXYXY»). Данным цветом будут отображаться:
Можно выбрать из пяти доступных шрифтов:
В качестве подложки карты можно использовать либо цвет, либо изображение. Цвет передается в шестнадцатеричном коде — Hex Code (значение цвета представлено в виде «#XYXYXY»). ! Цветом подложки карты является цвет бренда. Изображение должно быть в формате png. Максимальная высота изображения 285px (пикселей), максимальная ширина 430px (пикселей), а размер файла не более 500 KB. Рекомендуется использовать прозрачный фон.
Вы можете задать фон платежной страницы — цвет или изображение. Цвет фона передается в цветовом шестнадцатеричном коде — Hex Code (значение цвета представлено в виде «#XYXYXY»). Изображение должно быть в формате png. Максимальный размер файла не более 1 MB. Изображение масштабируется с сохранением пропорций таким образом, чтобы целиком поместиться внутри страницы.
9.6. Изменение текста кнопки оплаты
9.7. Размещение дополнительного текста на странице
Статусы счета и типы транзакций в системе WEBPAY
Статусы счетов
Ознакомиться со статусом счета можно выбрав в меню пункт «Счета». В системе WEBPAY по статусу счета делятся на следующие группы:
Ожидание оплаты — данный статус счет получает сразу после формирования и отправки уведомления на email плательщика. Вы можете увидеть в поле «Сумма заказа» сумму, на которую был выставлен счет.
Авторизован — счет получает данный статус после успешной авторизации, т.е. денежные средства заблокированы на банковской платежной карточке покупателя, но еще не списаны. Транзакция приобретет статус «Authorized».
Оплачен — счет получает данный статус после успешной оплаты, т.е. денежные средства списаны с карточки покупателя. В поле «Оплачено» отобразится сумма, которая была оплачена плательщиком и транзакция приобретет статус «Completed».
Не оплачен — оплата по счету не была произведена в установленный при создании срок. Для продления срока на оплату счета, следует нажать на кнопку «Изменить счет».
Сброшенный после авторизации — сброшенная после авторизации оплата, т.е. денежные средства разблокированы на карт-счете покупателя. Транзакция приобретает статус «Voided».
Частичная отмена — инициирован частичный возврат денежных средств на карт-счет покупателя. В поле «Оплачено» сумма равна разнице между суммой заказа и возврата. Транзакция приобретает статус «Refunded».
Отменен — инициирован возврат денежных средств на карт-счет покупателя. В поле «Оплачено» сумма равна нулю. Транзакция приобретает статус «Refunded».
Рекуррентный — рекуррентный (CoF) платеж. Платеж, осуществленный по привязанной карте без участия плательщика.
Важно!
Обращаем Ваше внимание, что при осуществлении оплаты через АИС «Расчет» (ЕРИП), счета будут приобретать только статусы: «Ожидание оплаты», «Оплачен» и «Не оплачен».
Типы операций в системе WEBPAY
В случае возникновения каких-либо претензий относительно качества предоставляемого товара или услуги, покупатель имеет право обратиться в интернет-магазин с просьбой произвести отмену платежа.
Для возврата списанных денежных средств, плательщик обязан обратиться к продавцу (интернет-магазину, интернет-ресурсу).
По правилам международных платежных систем возврат денежных средств может быть осуществлен только на ту банковскую карточку, при помощи которой была осуществлена оплата. Рекомендуется сохранять копию платежного извещения, получаемого на email при совершении платежа.
Важно!
Обратите внимание, что в системе WEBPAY возврат/отмену можно осуществить только по платежам, оплаченным через интернет-эквайринг. Оплаты через АИС «Расчет» (ЕРИП) возврату/отмене не подлежат.
Подтверждение и отмена авторизации
В момент оплаты происходит блокировка требуемой суммы на карточке плательщика, которая становится недоступна для использования. В системе WEBPAY такой платеж отмечается в списке платежей статусом «Authorized».
Реальное списание денежных средств с карточки плательщика происходит после финансового подтверждения платежа. После того, как финансовое подтверждение совершено, денежные средства с карточки клиента зачисляются на р/с Вашей компании в установленные договором интернет-эквайринга сроки.
Финансовое подтверждение может происходить в автоматическом или ручном режиме. В автоматическом режиме финансовое подтверждение происходит спустя 24 часа с момента авторизации. По Вашему желанию время совершения финансового подтверждения мы можем установить от одной минуты с момента авторизации до 72 часов.
В системе WEBPAY платеж, по которому осуществлено финансовое подтверждение отмечается в списке платежей статусом «Completed».
В системе WEBPAY существует две стадии прохождения платежей:
Авторизованные платежи в системе WEBPAY могут быть финансово завершены или сброшены (отменены).
Процедура отмены платежа включает следующие этапы:
После нажатия кнопки «Сбросить» платеж отклонится, вся оплаченная сумма разблокируется на карточке плательщика и станет доступной для использования. При этом транзакция приобретет статус «Сброшенная после авторизации» (Voided).
В случае нажатия кнопки «Завершение», авторизация по банковской карте подтверждается, транзакция завершается и денежные средства списываются с карты плательщика, а транзакция приобретает статус «Оплачен» (Completed).
Полный и частичный возврат денежных средств
В том случае, если платеж уже был завершен, т.е. транзакция получила статус «Completed», произвести сброс платежа не получится. В данном случае необходимо будет произвести «Возврат» либо «Частичный возврат» денежных средств.
Процедура возврата платежа включает следующие этапы:
После этого денежные средства возвращаются на карточку плательщика. Зачисление средств на карточку плательщика осуществляется, как правило, в течение недели, по карточкам, выпущенным белорусскими банками. По карточкам зарубежного банка срок возврата может достигать одного месяца. Данный параметр во многом зависит от банка, выпустившего карточку. После успешного возврата, транзакция приобретает статус «Частичная отмена/отменен» (Refunded).
Введение в среду разработки Sandbox
WEBPAY Sandbox — это самостоятельное Web-приложение, являющееся прототипом реальной системы и предназначенное для тестирования и ознакомления с возможностями реальной системы WEBPAY. По своим функциональным возможностям она ничем не отличается от рабочей копии, за исключением того, что не выполняет реального процессинга банковских карточек, т.е. никакие действия не приводят к реальному перемещению средств на карточках. Разработку и тестирование платежных модулей всегда необходимо производить в тестовой среде.
Параметры тестовой среды
| Название | Описание |
|---|---|
| URL адрес тестовой среды: | https://sandbox.webpay.by |
| Имя пользователя (login): | высылается в письме |
| Пароль: | высылается в письме |
| Уникальный идентификатор магазина ( wsb_storeid): | высылается в письме |
Для проведения тестовых транзакций можно использовать следующие параметры карточки (только в тестовой среде):
номер: 434179xxxxxx0051 (данное поле по умолчанию недоступно для редактирования)
CVV/CVC2: любые три цифры
срок действия карточки: любой. Для совершения оплаты с ошибкой введите декабрь месяц и год — текущий плюс 1. Например: текущий год 2019, значит значение должно быть 12/20.
Переход из тестовой среды в реальную
Обращаем Ваше внимание, что при переходе из тестовой в реальную среду проведения платежей необходимо выполнить ряд условий.
Смена адреса платежной страницы
Для совершения реальной оплаты заказа необходимо сформировать форму со специальными полями и POST методом перенаправить покупателя на страницу оплаты по адресу https://payment.webpay.by.
Адреса платежных страниц:
Важно!
В реальной среде обращение к https://payment.webpay.by должно осуществляться с доменного имени, которое было указано в договоре интернет-эквайринга. При этом по правилам платежных систем поддомен считается отдельным ресурсом. То есть, если Вы указали в договоре сайт https://test.by, то и перенаправление на нашу платежную страницу должно осуществляться с https://test.by. В случае если перенаправление будет с ресурса https://bill.test.by — транзакция будет заблокирована. Referer URL регулярно проверяется в соответствии с требованиями платежных систем и банков-эквайеров. В случае если Вы намереваетесь использовать адрес сайта отличный от заявленного в договоре, обратитесь, пожалуйста, к персональному менеджеру WEBPAY.
Также меняется адрес интерфейса Web-приложения:
Смена идентификатора магазина
Значение идентификатора магазина в системе WEBPAY передается в поле wsb_storeid. Данный параметр создается при регистрации и высылается в письме персональным менеджером в компании WEBPAY. Необходимо заменить его на значение идентификатора магазина ( wsb_storeid) из реальной среды.
Смена флага тестового платежа
При проведении платежей в тестовой среде в качестве флага о том, что оплату по заказу необходимо провести не через реальную систему, а с использованием эмулятора платежной системы, отвечало поле wsb_test со значением равным 1. Для проведения платежей через реальную систему, необходимо установить значение поля равным 0.
Интеграция платежей
Разработка платежного модуля осуществляется на стороне сервера подключаемого клиента и предполагает создание либо внесение изменений в исходный код скриптов дорабатываемого Web-приложения.
Карточные операции
Способы формирования заказа
Система WEBPAY предусматривает два способа формирования заказов на оплату:
Принцип формирования и оплаты заказа
Формирование заказа для оплаты
Для оплаты заказа необходимо сформировать JSON API запрос либо HTML форму со специальными полями, значения и описание полей представлены в разделе Поля формы оплаты, и POST методом перенаправить покупателя на страницу оплаты. Для тестирования необходимо указать адрес https://securesandbox.webpay.by, для совершения реальных платежей — https://payment.webpay.by.
Поля формы оплаты
Важно!
Все текстовые поля должны быть в кодировке UTF-8.
Основные поля формы оплаты
| Название поля | Обязательное поле | Описание поля | Примечание |
|---|---|---|---|
| *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 добавляются значения Идентификатора заказа ( wsb_order_num) и номера транзакции ( wsb_tid) в системе WEBPAY. |
| wsb_cancel_return_url | нет | URL адрес, на который возвращается покупатель в случае не успешной оплаты. | К данному URL добавляются значение Идентификатора заказа ( wsb_order_num). |
| wsb_notify_url | нет | В тестовой среде Sandbox значение данного поля должно быть равным 1. | |
| wsb_customer_name | нет | Наименование получателя товара/услуги. | Максимальная длина поля 255 символов. |
| wsb_customer_address | нет | Адрес получателя товара/услуги. | Максимальная длина поля 255 символов. |
| wsb_service_date | нет | Сроки предоставления товаров/услуг/работ. | Максимальная длина поля 255 символов. |
Поля для формирования корзины товаров/услуг
| Название поля | Обязательное поле | Описание поля | Примечание |
|---|---|---|---|
| wsb_invoice_item_name[ | да | Наименование единицы товара. | Индекс |
| wsb_invoice_item_quantity[ | да | Количество единиц товара. Целое число, обозначающее количество единиц товара каждого наименования. | Индекс |
| wsb_invoice_item_price[ | да | Цена единицы товара. Число, определяющее стоимость каждой единицы товара (BYN, USD, EUR, RUB с 2 знаками после запятой или точки). | Индекс |
| 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_order_tag | нет | Метка заказа. Используется для отнесения заказа к определенной категории, группировки заказов или других нужд. | Максимальная длина поля 64 символов. |
| wsb_email | нет | Электронный адрес покупателя. | Значение данного поля будет автоматически подставлено в соответствующее поле формы оплаты. |
| wsb_phone | нет | Номер телефона покупателя. | |
| wsb_order_contract | нет | Номер договора с заказчиком услуги/плательщиком. | |
| wsb_tab | нет | Определение активной вкладки с нужным платежным инструментом (оплата картой/ЕРИП). | Возможные значения: erip, cardPayment. При отсутствии поля порядок вкладок стандартный — оплата картой, потом ЕРИП. |
| wsb_card_number_short | нет | Значением является целое число, которое состоит из первых 6 и последних 4 цифр номера карты. Например: 1234561234. |
Пример кода
Параметры регулирования платежной сессии
Существует механизм регулирования времени отведенного на оплату со стороны Интернет-ресурса. Для этого в авторизационном запросе необходимо передать параметр, который будет указывать, с какого времени производить отсчет отведенного для оплаты интервала (по умолчанию 20 минут). В авторизационном запросе необходимо передать параметр wsb_startsessdatetime со значением типа DateTime (например, 2020-10-22T16:20:01+03:00) или параметр wsb_startsesstime, который содержит значение в формате UnixTimestamp (например, 1603383601). При передаче двух параметров, приоритетным считается wsb_startsessdatetime.
Например, транзакция начинается 22.10.2020 16:33:01, Интернет-ресурс хочет, чтобы платежная сессия действовала 7 мин., в POST запросе необходимо передать время 22.10.2020 16:20:01
Пример кода
Электронная подпись заказа
Электронная подпись формируется для предотвращения изменений в форме платежа и должна присутствовать в каждой форме заказа. Все заказы без электронной подписи не будут рассматриваться системой WEBPAY.
Для формирования электронной подписи необходимо установить значение поля «Секретный ключ» в настройках Вашего биллинг-аккаунта (Установка секретного ключа).
В каждой форме заказа необходимо указывать поля:
wsb_seed — случайная последовательность символов (можно использовать текущее значение времени, к примеру, Unix Timestamp);
wsb_signature — непосредственно сама электронная подпись. Она должна быть сформирована согласно следующему правилу из значений следующих полей:
Поля должны быть объединены в одну строку, порядок объединения не должен быть нарушен.
Далее в зависимости от указанной версии протокола ( wsb_version), считается MD5 (если версия не указана), либо SHA1 (для версии 2) объединенной строки.
Пример кода
Оплата заказа
После формирования полей заказа и нажатия кнопки для выполнения платежа, покупатель должен быть перенаправлен на платежную страницу системы WEBPAY (тестовой либо реальной), где ему будет предоставлена возможность ввести реквизиты своей банковской карточки.
После успешной оплаты заказа покупатель должен нажать кнопку «Вернуться на сайт», в этом случае форма оплаты перенаправит его по URL-адресу, указанному в поле wsb_return_url.
При ошибке оплаты и нажатии кнопки «Назад» покупатель будет перенаправлен на URL-адрес, указанный в поле wsb_cancel_return_url. В каждом из этих случаев к URL-адресу будут дописаны значения wsb_order_num, а в случае успешной оплаты, будет также дописано значение номера транзакции в системе WEBPAY.
Важно!
Возможны ситуации, при которых покупатель не нажмет кнопку «Назад» на форме оплаты. Для уведомления об успешной операции система WEBPAY, через некоторое время, отсылает специальный нотификатор (Нотификатор об оплате).
Нотификатор об оплате
В случае успешной оплаты, при возврате на страницу Интернет-ресурса (используется значение, указанное в поле wsb_return_url), система передает в параметрах GET запроса номер заказа (значение поля wsb_order_num) и номер транзакции (поле wsb_tid), соответствующие проведенному платежу.
Также система известит Интернет-ресурс о проведенной операции по адресу wsb_notify_url (если он указан в поле формы) либо на «URL для уведомлений», значение которого можно установить в настройках биллинг-аккаунта в разделе меню «Настройки» → «Компания».
Отправка нотификаторов от системы WEBPAY осуществляется с адреса: 178.163.225.84.
В случае если адрес для получения нотификатора будет указан и в поле формы ( wsb_notify_url), и в настройках биллинг-аккаунта, то будет использован адрес из POST-запроса, указанный в поле wsb_notify_url.
Интернет-ресурс, в случае оповещения, должен ответить кодом 200 («HTTP/1.0 200 OK»). Через 30 дней, если Интернет-ресурс так и не смог принять уведомление, отсылка запросов прекращается.
При разработке необходимо учесть, что может прийти как и извещение о платеже ( wsb_notify_url), так и покупатель может вернуться на страницу Интернет-ресурса, указанную в поле ( wsb_return_url).
Важно!
Обращаем внимание, что время платежной сессии составляет 20 минут и плательщик в течение этого времени может производить оплату, в связи с этим нотификатор не приходит сразу же после направления в систему WEBPAY авторизационного запроса на оплату.
Нотификатор отправляется только после получения системой WEBPAY результата оплаты. По умолчанию нотификатор отправляется только по успешным операциям. В случае необходимости получения нотификаторов и по неуспешным оплатам, рекомендуем обратиться в техническую поддержку WEBPAY.
Если в течении 20 минут после отправки Интернет-ресурсом авторизационного запроса плательщик не был перенаправлен по адресам wsb_return_url или wsb_cancel_return_url и/или Интернет-ресурсом не был получен нотификатор, то рекомендуем воспользоваться методом GetTransactionStatus API для управления карточными операциями либо обратиться в службу поддержки WEBPAY на support@webpay.by для уточнения статуса по операции.
Получение извещения об успешной оплате
Для получения извещения об оплате доступно два способа:
Стандартный POST-запрос, отправляемый с АПК WEBPAY на wsb_notify_url
После совершения удачного платежа, система WEBPAY отсылает специально сформированный POST-запрос по адресу, указанному в поле wsb_notify_url Интернет-ресурса. В этом запросе содержится информация по платежу. Полученную информацию Интернет-ресурс должен проверить в соответствии с требованиями выполнения заказа и ответить на запрос кодом 200 («HTTP/1.0 200 OK»).
Поля, содержащиеся в запросе:
wsb_signature представляет собой hex-последовательность и является результатом выполнения функции MD5. В качестве аргумента функции MD5 служит текстовая последовательность, полученная путем простой конкатенации следующих полей:
В случае необходимости можно самостоятельно отправить повторно нотификатор по авторизованной транзакции. Для этого в биллинг-аккаунте в разделе «Платежи» найдите интересующую транзакцию и нажмите кнопку «Отправить нотификатор».
Пример кода
Механизм SOAP
Для механизма SOAP (может быть включен по запросу), система WEBPAY отсылает специально сформированный SOAP-запрос по адресу, указанному в поле wsb_notify_url Интернет-ресурса. Структура нотификатора описана в xsd схеме:
WsbSignature представляет собой hex-последовательность и является результатом выполнения функции MD5. В качестве аргумента функции MD5 служит текстовая последовательность, полученная путем простой конкатенации следующих полей:
Поля должны быть объединены в указанном порядке.
Важно!
Поле SecretKey учитывается при формировании подписи только в реальной среде.