Клиенты совершают на вашем сайте целевые действия, такие как: покупка товаров, приглашение друзей, рассказ о вас в социальных сетях. За выполнение целевых действий им начисляются бонусные баллы, которые они могут обменять на подарки.
На странице лояльности, в pop-up или личном кабинете, клиент выбирает подарок.
В SailPlay поступает запрос, который обрабатывается системой(проверка кол-ва баллов клиента, вычитание баллов и пр.)
Далее, SailPlay отправляет JSONP-запрос на url обработчика партнера, со следующими GET-параметрами:
gift_public_key — уникальный хеш операции(выдачи подарка).
gift_sku — уникальный идентификатор(SKU/артикул, id) товара в вашей системе.
user_phone ИЛИ origin_user_id ИЛИ user_email.
http://example.com/gift-handler/?gift_public_key=yd63dj83dndncbc663&gift_sku=7777&user_phone=79001234567
После получения запроса партнер должен отправить запрос в SailPlay для проверки состояния выдачи подарка. В запросе к SailPlay должны присутвовать следующие GET-параметры:
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.