Advertisement
Not a member of Pastebin yet?
Sign Up,
it unlocks many cool features!
- 1. При переходе пользователя с кэшбэк-сервиса cashback.wwp.capital (далее Сервис) в интернет-магазин партнера (далее ИМ) в запросе GET-параметром (uid) будет передан уникальный идентификатор пользователя (УИД). Этот УИД необходимо сохранить любым доступным способом (сессия, cookies, внутреннее хранилище и т.п).
- 2. При оформлении заказа, сохраненный УИД необходимо связать с вновь сформированным заказом.
- 3. При любом изменении заказа (создание, оплата, отмена, подтверждение) сервер ИМ должен выполнять GET-запрос, сформированный по правилам описанным ниже, на сервер Сервиса по адресу https://cashback.wwp.capital/track
- 4. Сервер ИМ должен получить и обработать ответ сервера Сервиса и убедиться, что запрос из п.3 обработан сервером Сервиса.
- Правила формирования запросов:
- {merchant_id} – идентификатор интернет-магазина. Присваивается компанией и остается статичным.
- {user_id} – уникальный идентификатор пользователя Компании, который сделал заказ (УИД).
- {campaign_id} – идентификатор акции или специального предложения для покупателей, по которым необходимо получать конверсию.
- {category_id} – идентификатор категорий групп товаров, по которым ставки агентского вознаграждения различаются.
- {transaction_id} – номер заказа, параметр генерируется на стороне ИМ и должен быть уникальным для каждого заказа.
- {transaction_amount} – сумма заказа в национальной валюте (десятичная дробь, разделитель - точка. Точность - 2 знака после точки).
- {currency} – валюта в которой сформирован заказ (трехсимвольный формат, например USD).
- {transaction_amount_currency} - сумма заказа в валюте заказа (десятичная дробь, разделитель - точка. Точность - 2 знака после точки).
- {tt_date} – дата/время заказа (формат: ГГГГ-ММ-ДД-чч-мм-сс; 24-х часовой формат времени, месяца/дни/часы/минуты/секунды с ведущими нулями)
- {stat} – статус заказа (возможные варианты: new/paid/canceled/confirmed - соответственно: создан/оплачен/отменен/подтвержден)
- {hash} – контрольная сумма. Вычисляется как контрольная строка, зашифрованная по необратимому алгоритму MD5. Контрольная строка формируется объединением значений параметров: {mercant_id}::{user_id}::{campaign_id}::{category_id}::{transaction_id}::{transaction_amount}::{currency}::{transaction_amount_currency}::{tt_date}::{stat}::{secret_key}, где secret_key - выдается компанией и остается статичным.
- Пример формирования запроса:
- Исходные данные:
- {mercant_id} - 036dcb5e-eecd-45c5-a8c8-822552ee5507
- {user_id} - WP0000000001
- {campaign_id} - 712
- {category_id} - 12
- {transaction_id} - 345678
- {transaction_amount} - 123.12
- {currency} - USD
- {transaction_amount_currency} - 2.00
- {tt_date} - 2017-09-30-13-01-59
- {stat} - new
- {secret_key} - 141307a65ca563ad73eb39443661921b88dc45bea18e58e7a572117f8e59b59f
- Формируем контрольную строку:
- 036dcb5e-eecd-45c5-a8c8-822552ee5507::WP0000000001::712::12::345678::123.12::USD::2.00::2017-09-30-13-01-59::new::141307a65ca563ad73eb39443661921b88dc45bea18e58e7a572117f8e59b59f
- md5-хеш контрольной строки: 5fc881896c5fe129afc7963edb69f3d7
- Итоговый запрос:
- https://cashback.wwp.capital/track?mercant_id=036dcb5e-eecd-45c5-a8c8-822552ee5507&user_id=WP0000000001&campaign_id=712&category_id=12&transaction_id=345678&transaction_amount=123.12¤cy=USD&transaction_amount_currency=2.00&tt_date=2017-09-30-13-01-59&stat=new&hash=5fc881896c5fe129afc7963edb69f3d7
- Возможные ответы сервера:
- {status: "ok"} - запрос обработан
- {status: "error", error: "текст ошибки"} - обнаружена ошибка
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement