Модуль по полной интеграции к cashback платформе Switips
Бюджет:
3 000 Р
Внедрить модуль
СХЕМА ПОЛНОЙ ИНТЕГРАЦИИ
1. При переходе пользователя с кэшбэк
-
сервиса https://switips.com(далее
«Сервис») в интернет
-
магазин партнера (далее «ИМ») в запросе будет пе
редан
GET
-
параметром уникальный идентификатор пользователя (
uid
). Этот
uid
необходимо сохранить любым доступным способом (сессия,
cookies
, внутреннее
хранилище и т.п.).
2. При оформлении заказа сохраненный
uid
необходимо связать со вновь
сформированным заказом.
3. При любом изменении заказа (создание, оплата, отмена, подтверждение) сервер
ИМ должен выполнить
GET
-
запрос на сервер Сервиса по адресу
h
ttps://backend.switips.com/rest/partner/track
, сформированный по правилам
описанным ниже.
4. Сервер ИМ должен получить и обработать ответ сервера Сервиса и убедиться,
что запрос п.3 обработан сервером Сервиса.
ПРАВИЛА ФОРМИРОВАНИЯ ЗАПРОСОВ
{
merc
h
ant_id
}
–
идентификатор интернет
-
магазина. Присваивается компанией и
остается статичным.
{user
_
id
}
–
уникальный идентификатор пользователя Компании, который сделал
заказ (
uid
)
для тест
ирования
=
WP0000000001
.
{campaign
_
id
}
–
идентификатор акции или специального предложения для
покупателе
й, по которым необходимо получать конверсию
(по
умолчанию
=0)
.
{category
_
id
}
–
идентификатор категорий групп товаров, по которым ставки
агентского вознаграждения различаются
(по
умолчанию
=0)
.
{
commission_amount
}
–
с
умма агентской комиссии в валюте заказа (десятичная
дробь, разделитель
-
точка. Точность
-
2 знака после точки). Параметр
необязательный
.
Если этот параметр используется
, то он не
участвует
в
формировани
и контрольной строки, а только
в запросе.
{transaction
_
id
}
–
номер заказа. Параметр генерируется на стороне ИМ и должен
быть уникальным для к
аждого заказа.
{transaction
_
a
mount}
–
сумма заказа в национальной валюте (десятичная дробь,
разделитель
–
точка. Точность
–
2 знака после точки).
{currency}
–
валюта, в которой сформирован заказ (трехсимвольный формат,
например
RUB
).
{transaction
_
a
mount
_
c
urrency}
–
сумма заказа в валюте заказа (десятичная
дробь, разделитель
–
точка. Точность
–
2 знака после точки).
{tt
_
d
ate}
–
Дата и время заказа (формат:
yyyy
-
MM
-
ddTHH:mm:ssXXX; 24
-
х часовой
формат времени, месяца/дни/часы/минуты/секунды с ведущими нулями, между
датой и временем латинская буква T. В конце указывается часовой пояс. Пример:
“
2020
-
07
-
23T14:01:59+03:00
”)
{stat}
–
статус заказа (возможные варианты:
new/paid/canceled/confirmed
).
new
-
заказ создан
;
paid
-
заказ оплачен в
интернет
-
магазине покупателем
;
confirmed
-
сделка успешно завершена (при этом статусе
начисляет
ся
кэшбэк
пользователю
)
;
сanceled
-
заказ отменен, отказ, возврат и т.д.
.
{hash}
–
контрольная сумма. Вычисляется как контрольная строка, зашифрованная
по необратимому алгоритму MD5.
Контрольная строка форм
ируется объединением значений параметров:
{merchant_id}::{user_id}::{campaign_id}::{category_id}::{transaction_id}::{transaction_a
mount}::{currency}::{transaction_amount_currency}::{tt_date}::{stat}::{secret_key}, где
secret_key
-
выдается компанией и о
стается статичным.
ПРИМЕР ФОРМИРОВАНИЯ ЗАПРОСА
Исходные данные:
{
merc
h
ant_id
}
-
123
{
user_
id
}
-
WP0000000001
{
campaign_
id
}
-
0
{
category_
id
}
–
0
{
commission_amount
}
–
20.00 (
не
участвует
в формировани
и контрольной строки,
а только
в запросе
)
{
transaction
_id
}
-
345678
{
transaction_
a
mount
}
-
1000
.
00
{currency}
-
RUB
{
transaction_
a
mount_
c
urrency
}
-
1000
.00
{tt_d
ate}
-
2020
-
07
-
23T14:01:59+
03:00
{stat}
-
new
{secret_k
ey}
-
asdfg7afds98gf8gsd7fg7sdf98g7sdf98g7sdbv8sgb9sd6g75s4dfgb76sd
Формируем
контрольную
строку
:
123::WP0000000001::
0
::
0
::345678::
1000.00
::
RUB
::
1000.00
::
2020
-
07
-
23T14:01:59+03:00
::new::asdfg7afds98gf8gsd7fg7sdf98g7sdf98g7sdbv8sgb9sd6g75s4
dfgb76sd
md
5
-
хеш
контрольной
строки
:
1fc9c498bb2440eade05aeca73b2933d
*
в
се параметры в запросе должны быть
urlencoded
, например параметр
tt
_
date
в
контрольной строке =
2020
-
07
-
23T14:01:59+03:00
, тогда в запросе после
кодирования вид будет следующий:
2020
-
07
-
23T14%3A01%3A59%2B03%3A00
Итоговый
запрос
:
https
://
backend
.
switips
.
com
/
rest
/
partner
/
track
?
merc
h
ant
_
id
=123&
user
_
id
=
WP
00000000
01&
campaign
_
id
=
0
&
category
_
id
=
0
&
commission_amount=20.00
&
transaction
_
id
=345
678&
transaction
_
a
mount
=
1000.00
&
currency
=
RUB
&
transaction
_
amount
_
c
urrency
=
100
0.00
&
tt
_
d
ate
=
2020
-
07
-
23T14%3A01%3A59%2B03%3A00
&
stat
=
new
&
hash
=
1fc9c4
98bb2440eade05aeca73b2
933d
Возможные ответы сервера:
{status: "ok"}
-
запрос обработан;
{status: "error", error: "текст ошибки"}
-
обнаружена ошибка
6 ответов
3000рублей? это 2 часа работы по среднему чеку...
Ми
ха ил,
ну
что
ты
пишешь
как
то
стран
но
неу
доб
но
читать
твой
ответ.
Сорока на хвосте принесла, что был в маркете такой плагин. Пришли редиски из этой вашей организации и сказали, что нехорошо так делать. Поэтому, по цене массового плагина точно не получится. ))) думаю, что цена от 10 рабочих часов....
Какая стоимость вас устроит?
от 60 тыс рублей. ТЗ подробное, тогда оценка будет точнее и возможно значительно больше.
Добрый день
буду рад помочь (если бюджет не окончательный), пишите:
День добрый!
Готовы обсудить задачу, если бюджет будет увеличен.
mail@webry.ru
skype: webryru
Помогу, обращайтесь: siberian@sibprojects.com