Модуль по полной интеграции к 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 часа работы по среднему чеку...

    • Ми

      ха ил,

      ну

      что

      ты

      пишешь

      как

      то 

      стран

      но

      неу

      доб

      но 

      читать 

      твой

      ответ. 

      • Ирина Скворцова Ирина Скворцова 21 сентября 2020 15:28 #

        Технические условия подключения новых онлайн
        магазинов на CASHBACK платформу Switips
        СХЕМА ПОЛНОЙ ИНТЕГРАЦИИ
        1. При переходе пользователя с кэшбэк-сервиса https://switips.com(далее
        «Сервис») в онлайн магазин партнера (далее «ОМ») в запросе будет передан
        GET-параметром уникальный идентификатор пользователя (UID). Этот UID
        необходимо сохранить любым доступным способом (сессия, cookies, внутреннее
        хранилище и т.п.).
        2. При оформлении заказа сохраненный UID необходимо связать со вновь
        сформированным заказом.
        3. При любом изменении заказа (создание, оплата, отмена, подтверждение)
        сервер ИМ должен выполнить GET-запрос на сервер Сервиса по адресу
        https://switips.com/track, сформированный по правилам описанным ниже.
        4. Сервер ОМ должен получить и обработать ответ сервера Сервиса и убедиться,
        что запрос п.3 обработан сервером Сервиса.
        ПРАВИЛА ФОРМИРОВАНИЯ ЗАПРОСОВ
        {mercantID} – идентификатор онлайн магазина. Присваивается компанией и
        остается статичным.
        {userID} – уникальный идентификатор пользователя Компании, который сделал
        заказ (UID).
        {campaignID} – идентификатор акции или специального предложения для
        покупателей, по которым необходимо получать конверсию.
        {categoryID} – идентификатор категорий групп товаров, по которым ставки
        агентского вознаграждения различаются.
        {transactionID} – номер заказа. Параметр генерируется на стороне ОМ и должен
        быть уникальным для каждого заказа.
        {transactionAmount} – сумма заказа в национальной валюте (десятичная дробь,
        разделитель – точка. Точность – 2 знака после точки).
        {currency} – валюта, в которой сформирован заказ (трехсимвольный формат,
        например USD).
        {transactionAmountCurrency} – сумма заказа в валюте заказа (десятичная дробь,
        разделитель – точка. Точность – 2 знака после точки).
        {ttDate} – дата/время заказа (формат: ГГГГ-ММ-ДД_чч:мм:сс)
        {stat} – статус заказа (возможные варианты: new/paid/canceled/confirmed
        соответственно: создан/оплачен/отменен/подтвержден).
        {hash} – контрольная сумма. Вычисляется как контрольная строка,
        зашифрованная по необратимому алгоритму MD5.
        Контрольная строка формируется объединением значений параметров:
        {mercantID}::{userID}::{campaignID}::{categoryID}::{transactionID}::{transactionAmount}
        ::{currency}::{transactionAmountCurrency}::{ttDate}::{stat}::{secretKey}, где secretKey -
        выдается компанией и остается статичным.
        ПРИМЕР ФОРМИРОВАНИЯ ЗАПРОСА
        Исходные данные:
        {mercantID} - 123
        {userID} - WP0000000001
        {campaignID} - 712
        {categoryID} - 12
        {transactionID} - 345678
        {transactionAmount} - 123.12
        {currency} - USD
        {transactionAmountCurrency} - 2.00
        {ttDate} - 2017-09-31_13:01:59
        {stat} - new
        {secretKey} - asdfg7afds98gf8gsd7fg7sdf98g7sdf98g7sdbv8sgb9sd6g75s4dfgb76sd
        Формируем контрольную строку:
        123::WP0000000001::712::12::345678::123.12::USD::2.00::2017-09-
        31_13:01:59::new::asdfg7afds98gf8gsd7fg7sdf98g7sdf98g7sdbv8sgb9sd6g75s4dfgb76
        sd
        md5-хеш контрольной строки: 757746390df336c0498e826bc1d59432
        Итоговый запрос:
        ategoryID=12&transactionID=345678&transactionAmount=123.12&currency=USD&tran
        sactionAmountCurrency=2.00&ttDate=2017-09-
        31_13:01:59&stat=new&hash=757746390df336c0498e826bc1d59432
        Возможные ответы сервера:
        {status: "ok"} - запрос обработан;
        {status: "error", error: "текст ошибки"} - обнаружена ошибка
        • Сорока на хвосте принесла, что был в маркете такой плагин. Пришли редиски из этой вашей организации и сказали, что нехорошо так делать. Поэтому, по цене массового плагина точно не получится. ))) думаю, что цена от 10 рабочих часов.... 

  • Ирина Скворцова 21 сентября 2020 15:18 #

    Какая стоимость вас устроит?

  • Добрый день

    буду рад помочь (если бюджет не окончательный), пишите:

    • Почта: support@mr-x.su
    • Skype: mafan21
    • WhatsApp/Telegram/Viber: +37360885470
  • День добрый!

    Готовы обсудить задачу, если бюджет будет увеличен.

    mail@webry.ru

    skype: webryru

  • Помогу, обращайтесь: siberian@sibprojects.com

  • Добрый день, готов выполнить в кратчайшие сроки
    если актуально - пишите
    WhatsApp, Telegram: 89776780603
    zakaz@upsale.site

Откликнуться на заказ

Отклики на заказы могут добавлять только зарегистрированные эксперты и разработчики Webasyst. Стать экспертом.

Чтобы добавить комментарий, зарегистрируйтесь или войдите