Начните прямо сейчас

Зарегистрируйтесь или оставьте заявку на подключение к системе.

Даю согласие на передачу и обработку персональных данных.

В данном разделе содержится информация о программном интерфейсе для подключения интернет-магазинов к системе выдачи POS займов Webbankir pay. Если вы - интегратор, имеющий команду разработчиков и хотите интегрироваться глубоко, передавая информацию из собственных интерфейсов по API - обратите внимание на раздел для интеграторов

С помощью интерфейса возможно отправить покупателя на платежный фрейм Webbankir pay. Фрейм подзволяет создавать и подписывать клиентские займы, проверять предварительно одобренный лимит клиента, создавать заявки на получение лимита.

Общие сведения

Общий принцип обмена данных таков:

1
Покупатель формирует корзину товаров на вашем сайте
2
Вы отправляете покупателя методом POST redirrect на платежный фрейм, в процессе редирректа передавая состав корзины и прочую информацию
3
На платежном фрейме покупатель вводит свои данные
Если покупатель уже имеет активный лимит в системе Webbankir pay - то он направляется на подписание займа
4B
Если покупатель лимита еще не имеет - он отправляется на онлайн заявку на выдачу лимита, и после одобрения попадает на подписание займа
5
Покупатель возвращается в ваш магазин. На данном этапе информация о том, одобрен ли займ или нет, есть, но т.к. она передается в процессе возврата покупателя на сайт в открытом виде - доверять ей нельзя. Вы можете использовать ее для отображения успешной или неуспешной страницы, но не должны использовать ее для обновления статуса заказа
6
В межсерверном режиме по закрытому каналу мы передаем вам информацию о выданном займе. Вы можете изменить статус заказа на "оплачен" и приступить к отправке товара покупателю.
Отправка на платежный фрейм

Для того чтобы отправить покупателя на платежный фрейм вы должны сформировать HTML POST FORM с требуемыми полями, отрисовать его в браузере пользователя и установить автоматический (или ручной по нажатию на кнопку) submit формы (например с помощью JS). Action параметр тега form будет вести на платежный фрейм, таким образом покупатель попадет на фрейм Webbankir pay, где реализованы интерфейсы по подаче заявки на лимит и подписания займа.

Перечень полей формы (все они должны быть input type=hidden чтобы пользователь их не видел):

name
Формат value
Применение
Описание
merchantId
Numeric
Обязательный
ID мерчатнта в системе Webbankir. Можно посмотреть в личном кабинете
shopId
Numeric
Обязательный
ID магазина (отображается после создания магазина в личном кабинете)
shopPass
String
Обязательный
Пароль магазина, вводится вами при создании/редактировании магазина в личном кабинете
returnUrl
String
Необязательный
Ссылка, на которую нужно вернуть покупателя после одобрения или отказа в займе
orderId
String
Обязательный
Идентификатор заказа в вашей системе. Нужен для того, чтобы по нему в уведомлении о выдаче займа вы смогли выставить успешный статус заказа
sum
Numeric
Обязательный
Сумма заказа
ownFunds
Numeric
Необязательный
Средства, вносимые покупателем иным способом (например оплата наличными курьеру и т.д.)
webbankirFunds
Numeric
Обязательный
Сумма займа, которую планирует брать клиент
goods
Array
Обязательный
Массив товаров в корзине покупателя. Неуказание или неверное указание данных значений приведет к блокировке вашей учетной записи в системе Webbankir, информация из данного блока используется для формирования договора займа
goods[X][name]
String
Обязательный
Название товара
goods[X][cost]
Numeric
Обязательный
Стоимость товара
goods[X][is_returnable]
Integer
Обязательный
1 если товар подлежит возврату, 0 если не подлежит. Обычно 0 применяется для товара "Доставка"
Возврат пользователя

Возврат пользователя осуществляется на переданный вами returnUrl. На данный момент мы не передаем флаг успешности или неуспешности оформления займа клиентом при возврате покупателя на ваш сайт.

Процесс скоринга

Если покупатель не имеет лимита в системе Webbankir pay, то он будет отправлен на форму подачи заявки на лимит. После успешного заполнения формы покупатель получает в СМС как факт подачи заявки, так и факт одобрения лимита или отказа в выдаче лимита. Обычно процедура скоринга занимает до 5 минут, но в отдельных случаях может достигать 15 минут, если требуется дополнительная проверка заемщика. Если покупатель не закрыл фрейм и дождался одобрения не уходя с него - то он получит доступ к интерфейсу оформления займа. Если покупатель закрыл его и вернулся на ваш сайт - вы можете смело отправлять его повторно на платежный фрейм. Введя свой телефон он увидит результаты скоринга и сможет продолжить оформление займа.

Получение уведомлений

В случае успешно оформленного займа вы должны получить callback вызов на url, указанный в личном кабинете при создании магазина. Мы присылаем на url JSON со следующей информацией:

name
Формат value
Применение
Описание
sale_id
Numeric
Обязательный
ID выданного займа в системе Webbankir pay
shop_id
Numeric
Обязательный
ID магазина
order_id
String
Обязательный
Идентификатор заказа в вашей системе. Нужен для того, чтобы по нему вы смогли выставить успешный статус заказа
sum
Numeric
Обязательный
Сумма заказа
products
Array
Обязательный
Массив товаров в корзине покупателя.
products[X][name]
String
Обязательный
Название товара
products[X][cost]
Numeric
Обязательный
Стоимость товара
products[X][is_returnable]
Integer
Обязательный
1 если товар подлежит возврату, 0 если не подлежит. Обычно 0 применяется для товара "Доставка"

Для проверки валидности сообщения вы должны взять string представление JSON, сконкатенировать с паролем (хранящимся на вашей стороне), взять md5 хеш от получившейся строки, и сверить с хешом, присланным вам в заголовке wb-hash. Пример PHP кода - $headers = apache_request_headers(); return md5(file_get_contents('php://input') . $shopPass) === $headers['wb_hash'];

Если вы получили уведомление и проверка подлинности была пройдена - то это однозначное свидетельство того, что займ был выдан, и заказу можно выставлять статус "оплачен"

Возникли вопросы по работе API?
Напишите нам
Notification w/ confirmation

Notification w/ confirmation message