«Бизон.Касса» позволяет отправлять специальные сообщения другим системам (сервисам) по событиям "новый заказ", "частично оплаченный заказ" и "оплаченный заказ".
Если вы используете «Бизон.Курсы», то для настройки связи между «Кассой» и «Курсами» достаточно указать открываемые курсы в свойствах товара:
Описание формата пересылаемых данных
Данные пересылаются методом POST-запросов.
В body записываются следующие поля:
- action — действие
Значения: neworder (новый заказ), partialpaidorder (частично оплаченный заказ), paidorder (оплаченный заказ) - orderstatus — статус заказа
Значения: 1 - предварительный, 2 - оплаченный, 3 - частично оплаченный - user — идентификатор аккаунта в BIZON 365
- orderid — идентификатор заказа
- email — эл.адрес клиента
- phone — телефон клиента
- amount — сумма заказа
- paid — заказ оплачен полностью
Значения: false / true - paid_amount — оплаченная сумма
- refund_amount — сумма возврата
- currency — валюта заказа
Значения: RUR, UAH, USD, EUR, BYN, KZT - items — заказанные товары.
Формат: "id товара:количество:стоимость;"
Формат: [ { id: идентификатор товара в магазине, count: кол-во, price: стоимость }, { id: ..., count: .., price: ... }, ... ] - payby — способ оплаты (значение устанавливается только для оплаченных заказов)
Значения: yandex, yookassa (по API-протоколу), robokassa, paypal, bank (банки РФ), w1 (Единый кошелек) и другие - date — дата оплаты в ISO-формате
- refid — идентификатор партнера (первого уровня)
- ip — IP-адрес клиента
- city — город клиента, определенный по IP
- name — ФИО клиента в кодировке Windows-1251
- name_utf8 — ФИО клиента в кодировке UTF-8
- channel — идентификатор канала клиента (тоже самое, что поле "Заказ после" в интерфейсе Кассы)
- appear — идентификатор канала появления клиента (тоже самое, что поле "Появление" в интерфейсе Кассы)
- coupon — использованный купон на скидку
- clientId — значение пользовательского поля в собственной форме заказа
- custom1, custom2, custom3 — дополнительные поля, если указаны в собственной форме заказа
- accessdata — строка с логином и паролем для каждого товара
Формат:id1:login:password:;id2:login:password:;
Старый формат:id1:login:password:P1;id2:login:password:P2;- где P1 и P2 - это период доступа к товарам id1 и id2 соответственно (в днях). Изменение с 17.08.2020: в связи с отключением поля "Срок доступа" в настройках товара, значений P1, P2 теперь нет. - hash — контрольная сумма.
Вычисляется как MD5-хэш строки из объединенных полей: action + user + API-ключ Кассы + orderid (без знаков +) - secret — секретное слово для доступа к заказу
Зная секретное слово и номер заказа, можно формировать ссылки на оплату для клиентов:
https://online.bizon365.ru/kassa/XXXX/order/orderid?hash=secret
где XXXX — id вашего аккаунта в Бизоне. - netid — id покупателя в соцсети, если оформление заказа осуществлялось через соцсеть
- network — название соцсети, если оформление заказа осуществлялось через соцсеть
- avatar — ссылка на аватар покупателя, если заказ оформлялся через соцсеть.
- utm_* — utm-метки: utm_source, utm_medium, utm_campaign, utm_term, utm_content, utm_group
- sup — Параметр подписчика (значение Произвольного параметра в URL страницы регистрации)
- customUrlParam — значение пользовательского url-параметра, задаваемого в настройках вебинарной комнаты (cu1)
- customRoomFields — набор значений дополнительных полей ввода информации на странице входа в вебинарную комнату (cv)
Пример:
customRoomFields: {
c: { title: 'Город', value: 'Магадан' },
m_tg: { title: 'Telegram', value: '@telega' }
}