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

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

  1. Клиенты совершают на вашем сайте целевые действия, такие как: покупка товаров, приглашение друзей, рассказ о вас в социальных сетях. За выполнение целевых действий им начисляются бонусные баллы, которые они могут обменять на подарки.

  2. На странице лояльности, в pop-up или личном кабинете, клиент выбирает подарок.

  3. В SailPlay поступает запрос, который обрабатывается системой(проверка кол-ва баллов клиента, вычитание баллов и пр.)

  4. Далее, SailPlay отправляет JSONP-запрос на url обработчика партнера, со следующими GET-параметрами:

    1. gift_public_key — уникальный хеш операции(выдачи подарка).

    2. gift_sku — уникальный идентификатор(SKU/артикул, id) товара в вашей системе.

    3. user_phone ИЛИ origin_user_id ИЛИ user_email.

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

http://example.com/gift-handler/?gift_public_key=yd63dj83dndncbc663&gift_sku=7777&user_phone=79001234567

 

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

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

    1. gift_public_key — уникальный хеш, котороый был отпарвлен в GET-параметрах на url партнера.

    2. token — авторизационный токен(подробнее).

    3. store_department_id — id вашего магазина в системе SailPlay(получить).

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

http://sailplay.ru/api/v1/ecommerce/gifts/commit-transaction/?token=nbnb34hd7hehbde7bde&store_department_id=xxx& gift_public_key=yd63dj83dndncbc663

 Пример ответа

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

 

Если запрос успешен(status = ok) и выдача подарка ранее не была завершена(already_completed = false), то вы можете добавить клиенту в корзину товар с переданным SKU.