Интеграция на WP

Схема интеграции: 

1. При переходе пользователя с кэшбэк-сервиса https://switips.com(далее

«Сервис») в интернет-магазин партнера (далее «ИМ») в запросе будет передан

GET-параметром уникальный идентификатор пользователя (uid). Этот uid

необходимо сохранить любым доступным способом (сессия, cookies, внутреннее

хранилище и т.п.).

2. При оформлении заказа сохраненный uid необходимо связать со вновь

сформированным заказом.

3. При любом изменении заказа (создание, оплата, отмена, подтверждение) сервер

ИМ должен выполнить GET-запрос на сервер Сервиса по адресу

https://backend.switips.com/rest/partner/track, сформированный по правилам

описанным ниже.

4. Сервер ИМ должен получить и обработать ответ сервера Сервиса и убедиться,

что запрос п.3 обработан сервером Сервиса.

ПРАВИЛА ФОРМИРОВАНИЯ ЗАПРОСОВ

{merchant_id} – идентификатор интернет-магазина. Присваивается компанией и

остается статичным.

{user_id} – уникальный идентификатор пользователя Компании, который сделал

заказ (uid).

{campaign_id} – идентификатор акции или специального предложения для

покупателей, по которым необходимо получать конверсию.

{category_id} – идентификатор категорий групп товаров, по которым ставки

агентского вознаграждения различаются.

{transaction_id} – номер заказа. Параметр генерируется на стороне ИМ и должен

быть уникальным для каждого заказа.

{transaction_amount} – сумма заказа в национальной валюте (десятичная дробь,

разделитель – точка. Точность – 2 знака после точки).

{currency} – валюта, в которой сформирован заказ (трехсимвольный формат,

например RUB).

{transaction_amount_currency} – сумма заказа в валюте заказа (десятичная

дробь, разделитель – точка. Точность – 2 знака после точки).

{tt_date} – Дата и время заказа (формат: yyyy-MM-ddTHH:mm:ssXXX; 24-х часовой

формат времени, месяца/дни/часы/минуты/секунды с ведущими нулями, между

датой и временем латинская буква T. В конце указывается часовой пояс. Пример:

“2019-07-08T14:01:59+03:00”)

{stat} – статус заказа (возможные варианты: new/paid/canceled/confirmed

соответственно: создан/оплачен/отменен/подтвержден).

{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 - выдается компанией и остается статичным.

ПРИМЕР ФОРМИРОВАНИЯ ЗАПРОСА

Исходные данные:

{merchant_id} - 123

{user_id} - WP0000000001

{campaign_id} - 0

{category_id} - 0

{transaction_id} - 345678

{transaction_amount} - 1000.00

{currency} - RUB

{transaction_amount_currency} - 1000.00

{tt_date} - 2019-07-08T14:01:59+03:00

{stat} - new

{secret_key} - asdfg7afds98gf8gsd7fg7sdf98g7sdf98g7sdbv8sgb9sd6g75s4dfgb76sd

Формируем контрольную строку:

123::WP0000000001::0::0::345678::1000.00::RUB::1000.00::2019-07-

08T14:01:59+03:00::new::asdfg7afds98gf8gsd7fg7sdf98g7sdf98g7sdbv8sgb9sd6g75s4

dfgb76sd

md5-хеш контрольной строки: 99f69b305de5357f344d5ced2117d485

*все параметры в запросе должны быть urlencoded, например параметр tt_date в

контрольной строке = 2019-07-08T14:01:59+03:00, тогда в запросе после

кодирования вид будет следующий:

2019-10-2019-07-08T14%3A01%3A59%2B03%3A00

Итоговый запрос:

https://backend.switips.com/rest/partner/track?merchant_id=123&user_id=WP00000000

01&campaign_id=0&category_id=0&transaction_id=345678&transaction_amount=1000.

00¤cy=RUB&transaction_amount_currency=1000.00&tt_date=2019-07-

08T14%3A01%3A59%2B03%3A00&stat=new&hash=99f69b305de5357f344d5ced2117

d485

Возможные ответы сервера:

{status: "ok"} - запрос обработан;

{status: "error", error: "текст ошибки"} - обнаружена ошибка