Добавление подарка в корзину

Процесс выдачи подарка (первая часть)

  1. Ваш клиент совершает полезные для вас действия (совершает покупки, рассказывает о вашем сайте в социальных сетях, приглашает друзей и т.д.), за что получет бонусные баллы. После того, как у клиента накопится достаточное количество бонусных баллов, он сможет получить подарок.

  2. Для этого клиент выбирает в popup’е подарок, который он хочет получить, нажимает кнопку "Получить".

  3. В системе SailPlay создается транзакция, которой присваивается уникальный hash.

  4. Если включена опция "Подтверждать получение подарка SMS-сообещнием", SailPlay отправляет пользователю SMS с уникальным числовым кодом, который ему нужно ввести в специальном поле в popup’е.
  5. В случае, если пользователь введет правильный SMS-код, из popup'а будет сделан JSONP-запрос, на адрес, который партнер указал в своей админской панели в системе SailPlay. В запросе будут переданы следующие GET-параметры:

    1. gift_public_key: уникальный hash ;

    2. gift_sku: идентификатор подарка в вашей системе;

    3. user_phone: номер телефона пользователя;

Пример запроса, который будет сделан к сайту партнера

http://amazon.com/sailplay-listener/?gift_public_key=09kdhh472idgh785920kfa&gift_sku=4829&user_phone=79141003334

Процесс выдачи подарка (вторая часть)

  1. При получении данного запроса, сайт партнера должен инициализировать API-запрос к SailPlay для проверки статуса транзакции. В запросе необходимо передать следующие GET-параметры:

    1. gift_public_key: уникальный hash, который был передан в предыдущем запросе

    2. token

    3. store_department_id

Пример запроса

http://sailplay.ru/api/v1/ecommerce/gifts/commit-transaction/?token=7ce324861c4a5de5bfe931c04d96073f9b72bfec&store_department_id=122&gift_public_key=09kdhh472idgh785920kfa

 Формат ответа

{
"status": "ok",
"purchase_gift": {
"id": 166,                   //id транзакции
"already_completed": false,  //была ли уже проведена транзакция
"gift": 20,                  //id подарка в системе SailPlay.ru
"gift_sku": "123",           //идентификатор подарка в системе партнера
"purchase_date": "2013-03-26T10:18:41",       
"complete_date": "2013-03-26T10:19:04.118",
"points_delta": 800,
"is_completed": true,
"user": "79149004432"
}
}

 

В случае успеха, данному пользователю необходимо выдать (добавить в корзину) товар с данным SKU.