Advertisement
Guest User

Untitled

a guest
Oct 23rd, 2017
360
0
Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
text 5.08 KB | None | 0 0
  1. 1. При переходе пользователя с кэшбэк-сервиса cashback.wwp.capital (далее Сервис) в интернет-магазин партнера (далее ИМ) в запросе GET-параметром (uid) будет передан уникальный идентификатор пользователя (УИД). Этот УИД необходимо сохранить любым доступным способом (сессия, cookies, внутреннее хранилище и т.п).
  2. 2. При оформлении заказа, сохраненный УИД необходимо связать с вновь сформированным заказом.
  3. 3. При любом изменении заказа (создание, оплата, отмена, подтверждение) сервер ИМ должен выполнять GET-запрос, сформированный по правилам описанным ниже, на сервер Сервиса по адресу https://cashback.wwp.capital/track
  4. 4. Сервер ИМ должен получить и обработать ответ сервера Сервиса и убедиться, что запрос из п.3 обработан сервером Сервиса.
  5.  
  6. Правила формирования запросов:
  7. {merchant_id} – идентификатор интернет-магазина. Присваивается компанией и остается статичным.
  8. {user_id} – уникальный идентификатор пользователя Компании, который сделал заказ (УИД).
  9. {campaign_id} – идентификатор акции или специального предложения для покупателей, по которым необходимо получать конверсию.
  10. {category_id} – идентификатор категорий групп товаров, по которым ставки агентского вознаграждения различаются.
  11. {transaction_id} – номер заказа, параметр генерируется на стороне ИМ и должен быть уникальным для каждого заказа.
  12. {transaction_amount} – сумма заказа в национальной валюте (десятичная дробь, разделитель - точка. Точность - 2 знака после точки).
  13. {currency} – валюта в которой сформирован заказ (трехсимвольный формат, например USD).
  14. {transaction_amount_currency} - сумма заказа в валюте заказа (десятичная дробь, разделитель - точка. Точность - 2 знака после точки).
  15. {tt_date} – дата/время заказа (формат: ГГГГ-ММ-ДД-чч-мм-сс; 24-х часовой формат времени, месяца/дни/часы/минуты/секунды с ведущими нулями)
  16. {stat} – статус заказа (возможные варианты: new/paid/canceled/confirmed - соответственно: создан/оплачен/отменен/подтвержден)
  17. {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 - выдается компанией и остается статичным.
  18.  
  19. Пример формирования запроса:
  20.  
  21. Исходные данные:
  22. {mercant_id} - 036dcb5e-eecd-45c5-a8c8-822552ee5507
  23. {user_id} - WP0000000001
  24. {campaign_id} - 712
  25. {category_id} - 12
  26. {transaction_id} - 345678
  27. {transaction_amount} - 123.12
  28. {currency} - USD
  29. {transaction_amount_currency} - 2.00
  30. {tt_date} - 2017-09-30-13-01-59
  31. {stat} - new
  32. {secret_key} - 141307a65ca563ad73eb39443661921b88dc45bea18e58e7a572117f8e59b59f
  33.  
  34. Формируем контрольную строку:
  35. 036dcb5e-eecd-45c5-a8c8-822552ee5507::WP0000000001::712::12::345678::123.12::USD::2.00::2017-09-30-13-01-59::new::141307a65ca563ad73eb39443661921b88dc45bea18e58e7a572117f8e59b59f
  36.  
  37. md5-хеш контрольной строки: 5fc881896c5fe129afc7963edb69f3d7
  38.  
  39. Итоговый запрос:
  40.  
  41. 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&currency=USD&transaction_amount_currency=2.00&tt_date=2017-09-30-13-01-59&stat=new&hash=5fc881896c5fe129afc7963edb69f3d7
  42.  
  43. Возможные ответы сервера:
  44. {status: "ok"} - запрос обработан
  45. {status: "error", error: "текст ошибки"} - обнаружена ошибка
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement